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Preface 


This manual is one of a series designed to instruct and guide you in using the SPERRY 
UNIVAC Information Management System (IMS) for Operating System/3 (OS/3) in both 
a System 80 environment and in a Series 90 environment. Throughout this manual, we 
use the term Series 90 to refer to SPERRY UNIVAC 90/25, 90/30, 90/30B, and 90/40 
systems. 


This manual is intended for the IMS administrator and the systems analyst. It gives an 
overview of the IMS package and fully describes the system preparation and system 
functions. 


Before reading this manual, you should have a fundamental understanding of the IMS 
theory, how it operates, and what you need to do to make it operational. This 
information is contained in the IMS concepts and facilities manual, UP-9205 (current 
version). 


The information in this manual is presented as follows: 
m SECTION 1. INTRODUCTION 


Discusses the purpose of IMS and the services it provides. Describes the functions 
you must perform to tailor IMS to your requirements and the modules in the IMS 
library that will become part of your IMS system. Explains IMS support of basic 
data management files in DTF mode and of consolidated data management files in 
CDM mode. 


mB SECTION 2. COMMUNICATIONS SUPPORT WITH ICAM 


Describes the software interface between your IMS system and your terminals. 
Explains how to create an ICAM symbiont to support your terminal network and 
the necessary interfaces. Discusses the network definition macros that generate the 
ICAM symbiont. 


m SECTION 3. PRE-ONLINE PROCESSING 


Lists the utilities and procedures you may execute before any online processing 
occurs, in order to define your particular online operating environment. Tells you 
how to initialize and list the named record (NAMEREC) file, to which all IMS 
processors contribute records, and how to define passwords. 
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m SECTION 4. CONFIGURING IMS 





Lists the five job steps that comprise the configuration process and describes how 
to configure IMS. Describes how to generate and execute the control streams that 
generate IMS. Also, describes in detail the 12 logical sections that make up your 
input to the IMS configurator. 


m SECTION 5. INITIATING AND TERMINATING IMS 
Briefly tells you how to start and end an IMS session under normal and emergency 
conditions. Discusses how to load ICAM and establish a global network. Also, 
explains the job control stream needed to load IMS and describes how you can 
replace action programs while IMS is running. Describes how to bring IMS to a 
normal or emergency halt. 

mw SECTION 6. BATCH PROCESSING OF TRANSACTIONS 
Describes how: 
- batch processing works and when to use it. 


- input and output messages are handled. 


- to set up the batch environment. 





— to prepare input for the batch processor. 
- to start and control batch processing. 
— to run IMS batch processing without a communications network. 
-— to resume batch processing after a warm or cold restart. 

m SECTION 7. FILE RECOVERY 
Discusses online and offline file recovery functions. Describes the audit file, terminal 
output message file, and trace file. Explains what you need to do at configuration 
time and execution time in order to use these files. Describes IMS file recovery 
after a transaction is abnormally terminated or after a system restart. Also, tells 


how you can restore damaged files or files left in an inconsistent state after IMS 
termination or system failure. 
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SECTION 8. IMS STATISTICAL REPORTING 


Gives an overview of the statistical reporting functions, and lists all statistical data 
printed. Describes the information you must supply to the configurator if you want 
IMS to print statistical data. Explains how and when statistical data is recorded, 
and describes the steps you must take to run the statistical print program. 


APPENDIXES 


Appendix A describes the conventions of IMS statement and parameter formats. 
Appendix B provides guidelines for estimating main storage requirements for 
executing single-thread and multithread IMS systems under OS/3. Appendix C 
discusses some ways to ensure the most efficient performance of IMS under OS/3. 
Appendix D shows the component structure of IMS. Appendix E lists UNIQUE 
language elements and maximum length allowed for their replacements. Appendix F 
lists and describes error messages generated by the NAMEREC file utility, the 
configurator, and the batch transaction processor. 


As one of a series, this manual is designed to guide you in configuring and controlling 
IMS. Depending on your needs, you should also refer to the current versions of other 
manuals in the series. Complete manual names, their ordering numbers, and a general 
description of their contents and use are as follows: 


Information Management System (IMS) concepts and facilities, UP-9205 
Describes the basic concepts of IMS and the facilities it offers. 


Information Management System (IMS) action programming in RPG Il user guide, 
UP-9206 


Describes how to write action programs in RPG ll, with extensive examples. 


Information Management System (IMS) action programming in COBOL and basic 
assembly language (BAL) user guide, UP-9207 


Describes how to write action programs in COBOL and BAL, with extensive 
examples. 


Information Management System (IMS) terminal users guide, UP-9208 
Describes terminal operating procedures, standard and master terminal commands, 
and special purpose IMS transaction codes. The manual is in easel format for ease 


of use at the terminal. 


Information Management System (IMS) data definition and UNIQUE user guide, 
UP-9209 


Describes how to write data definitions and how to use UNIQUE commands to 
access defined files. 
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IMS/DMS interface user guide, UP-8748 


Describes how to access a data base management system (DMS) data base from 
IMS. 


The IMS administrator and systems analyst should also be familiar with the current 
versions of the following OS/3 documents: 


System installation user guide/programmer reference (Series 90 environment), 
UP-8074 


System installation user guide/programmer reference (System 80 environment), 
UP-8839 


System messages programmer/operator reference, UP-8076 
Job control user guide, UP-8065, or programmer reference, UP-8217 
Integrated communications access method (ICAM) concepts and facilities, UP-8194 


Integrated communications access method (ICAM) network definition and 
operations user guide, UP-8947 


System service programs (SSP) user guide, UP-8062, or programmer reference, 
UP-8209 
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1. Introduction 


1.1. OVERVIEW 


The SPERRY UNIVAC Information Management System (IMS) is a transaction-oriented 
data file processing system that supports online inquiries from remote terminals for the 
purpose of examining or updating your files. For each message, IMS performs the 
requested processing and responds with an output message to the originating terminal. 
With IMS, your programmers do not have to be data communications experts because 
IMS provides you with the following services: 


m™ access to your data files; 

= ~=verifying, editing, and scheduling communications messages; 

m scheduling processing sequences depending on message context; and 
™ = =communications network access 


IMS also provides for the data integrity and data security necessary in real-time 
processing. Data modifications are logged, and both online and offline data file recovery 
are available. 


In addition to online transaction processing, IMS provides a batch transaction processor, 
which you may use in offline or online mode for production runs involving batched 
transactions or for testing new applications. 


IMS, as supplied by Sperry Univac, is a collection of software components that you 
must adapt to the individual requirements of your installation. You create your own 
online IMS system in a configuration process (Section 4) in which you describe your 
communications network, your files, and your applications, and select the optional 
features you want included. The output of the configuration process is an IMS load 
module that operates as a communications user program interfacing with the integrated 
communications access method (iICAM). Generation procedures for an ICAM symbiont 
that supports IMS are described in Section 2. 


In addition to the modules that are used to configure your online IMS system, IMS 
components include utility programs for pre-online processing of your applications and 
for offline recovery of your data files. 
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1.1.1. Transaction Processing 





When you want to access your files, you enter a transaction code at a remote terminal. 
This initiates a transaction, which is a series of related input messages, file accesses, 
and responses. Each input message-output response sequence in the transaction is 
called an action. Transactions are handled by action programs that interact with the 
online IMS load module for system services. (They do not actually access your data 
files but call on IMS to do so.) 


IMS provides a set of action programs called the uniform inquiry update element 
(UNIQUE) that allow you to retrieve, add, delete, and change records in your files by 
entering simple commands from terminals. To use UNIQUE, you must define your file 
structure and the restrictions you want to place on file updating in a data definition, 
described in the IMS data definition and UNIQUE user guide, UP-9209 (current version). 





If you have special file processing or message formatting needs that cannot be handled 
by UNIQUE, you can write your own action programs in basic assembly language (BAL), 
COBOL, or RPG Il; these are described in the current versions of the IMS action 
programming in COBOL and basic assembly language user guide, UP-9207, and IMS 
action programming in RPG Il user guide, UP-9206. Action programs can access 
conventional indexed sequential access method (ISAM), multi-indexed random access 
method (MIRAM), direct access method (DAM), and sequential access method (SAM) 
disk files, MIRAM diskette files, and SAM tape files. Or you can access your files 
through the medium of defined files in which elements of your data files are logically 
combined to meet the requirements of a particular application. You do this by writing a 
data definition. 





COBOL action programs can also access a data base management system (DMS) data 
base. You can use a data base as a source file in a data definition and then access the 
defined file you created through your COBOL, RPG Il, or BAL action programs or 
UNIQUE. For more information, refer to the IMS/DMS interface user guide, UP-8748 
(current version). 


1.1.2. Single-thread and Multithread IMS Systems 


The IMS system you configure can be either single-thread or multithread. In a 
single-thread IMS system, only one action can be processed at a time, but actions for 
different transactions can be interspersed. Since the duration of an action is normally 
short, IMS can concurrently handle transactions originating from several terminals with 
very little delay in response time. Multithread IMS allows concurrent processing of 
actions for different transactions, providing better performance, but requires more main 
storage. 


Appendix B provides information on main storage requirements, and Appendix C 
discusses processing performance in single-thread and multithread IMS systems. 
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You can configure more than one IMS load module if your applications have varying 
requirements. That way, you can minimize main storage requirements by including only 
the options you need for each application and by configuring a single-thread or 
multithread load module as best suits the application. 


NOTE: 


Regardless of the type of IMS system you configure, your processor must be equipped 
with the storage protection feature. 


1.2. GENERATING AN IMS SYSTEM 


The process of generating a tailored IMS system starts at system generation (SYSGEN), 
when you must generate a supervisor that supports IMS, include the appropriate ICAM 
and IMS library modules in your system resident (SYSRES) disk volume (unless you use 
the OS/3 release volume (OS/3REL) as your SYSRES), and generate an ICAM module 
that supports your IMS system. For details on the SYSGEN process, refer to the 
appropriate system installation guide for your system. 


Depending on the requirements of your applications, you must perform some or all of 
the following functions in preparation for online processing: 


m= = Initialize the named record (NAMEREC) file, which contains all the tables and 
records needed by online IMS. This can be done as part of the configuration 
process or separately with the NAMEREC file utility, ZP#NRU. (See Section 3.) 


m Generate passwords for use with UNIQUE, using the same NAMEREC file utility. 
(See Section 3.) 


m Write data definitions for defined files, required for UNIQUE and optional for use 
with user action programs. Data definitions are processed by the data definition 
processor, DT3DF, described in the IMS data definition and UNIQUE user guide, 
UP-9209 (current version). 


m Write action programs in BAL, COBOL, or RPG Il to handle your applications for 
which you do not use UNIQUE. Action program preparation is described in the IMS 
action programming user guides. 


m= Generate edit tables for use with your action programs, using the edit table utility, 
ZH#EDT (also described in the IMS action programming manuals). These tables 
simplify input message editing and validation. 


= Configure an online IMS load module, using the IMS job control procedure (jproc), 
IMSCONF. (See Section 4.) The configuration process also allocates and initializes 
the internal files needed by online IMS. 
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Generation of an IMS system is illustrated in the flowchart in Figure 1-1, which also 
shows online processing and offline recovery functions. The pre-online sequence shown 
is interchangeable, with three exceptions. 


lis 


2 


Supervisor generation must always be the first step. 


The ICAM load module must be generated before configuration. 


The NAMEREC file must be initialized before or during configuration and before 
processing of data definitions, passwords, or edit tables. If the NAMEREC file is 
reinitialized at any time, all pre-online processing, including configuration, must be 
repeated. 


1.2.1. OS/3 System Generation Considerations 


When you generate an OS/3 operating system to support IMS, you must consider a 
number of points in the SUPGEN, RESGEN, and COMMCT phases of SYSGEN. (The 
RESGEN phase applies only to Series 90 systems.) 


1. 


In the supervisor generation (SUPGEN) phase, you must: 


specify TIMER=MAX to include the GETIME and SETIME macros in the timer 
services available for your I/O devices. 


specify the number of communications adapters and communications lines to 
be supported, using the COMM keyword parameter. 


specify at least three transient areas (TRANS=3) for a single-thread IMS 
system; at least four for multithread. If other jobs will run with IMS, allocate at 
least five transient areas. 


specify at least two task priority levels (PRIORITY=2) for single-thread IMS; at 
least four for multithread. 


specify a symbiont priority (SYMBPRI=n) larger than the lowest priority used 
by IMS (higher numbers equal lower priorities). For single-thread, specify at 
least 2; for multithread, at least 4. 


specify at least two job slots to provide the necessary storage keys for IMS. If 
other jobs will run with IMS, allocate at least three job slots. 


in a Series 90 environment, specify DTF, CDM, or mixed data management 
mode (DMGTMODE parameter) based on which version of IMS (DTF or CDM) 
you intend to use. In a System 80 environment, you always have CDM mode. 


for Series 90, specify FILELOCK=YES or SHARE to include file locking 
capability in your system. File locking capability is automatically included in 
System 80 control systems. 
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If you intend to process batched transactions and have only one printer available, 
you also must include the appropriate spooling capability in your supervisor. 
Additional SUPGEN specifications that can improve processing performance under 
IMS are discussed in Appendix C. 





2. Ina Series 90 environment, you can either use the OS/3 release volume (OS/3REL) 
as your permanent SYSRES or include a RESGEN section to generate a SYSRES 
volume. These considerations do not apply to System 80 users. In the RESGEN 
phase, you must: 


m ~~ specify the 2K version of control storage (COS) code with the COS keyword 
parameter. (If you do not include a RESGEN section, you must replace the 1K 
version of COS code on OS/3REL with the 2K version by running the canned 
job control stream PRP2KCOS, as described in the system service programs 
(SSP) user guide, UP-8062 (current version).) 


™ not specify the ICAM subparameter on the DELETE keyword parameter 
because this would exclude the ICAM procedure modules from your SYSRES 
volume. 


™ not specify the IMS subparameter on the DELETE keyword parameter because 
this would exclude the IMS online and utility modules from your SYSRES 
volume. You may, however, specify IMSGEN with the DELETE subparameter to 
exclude the configurator object and load modules and the recovery object 
modules from your SYSRES. These modules are needed only when you 
configure your IMS system and when you link your recovery program and tape 
copy routine (if required). If you exclude the IMSGEN modules, the OS/3REL 
volume must be online at configuration time, and you should link your recovery 
and tape copy programs immediately after configuration. 





3. You must generate an ICAM load module that supports IMS in the COMMCT 
phase. You can do this at the same time you generate a supervisor or later in a 
separate SYSGEN. Details on generating an ICAM module that supports IMS are in 
Section 2. 


1.3. IMS COMPONENT STRUCTURE 


The IMS library that you receive as part of the OS/3 software contains a collection of 
source, object, and load modules. Most of these modules become part of your online 
IMS system; they perform such functions as applications management and _ internal 
message control. Some modules are included in every IMS system; others are optional. 


In addition to the components that become part of your online IMS system, the IMS 
library includes the following programs: 


m Configurator programs: ZS#CNF for single-thread IMS, ZO#CNF for multithread. The 
configurator program is executed by an IMS jproc, IMSCONF. 





m= The NAMEREC file utility, ZP#NRU, which initializes the NAMEREC file and 
generates passwords. 
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The data definition processor, DT3DF, with which you create defined files. 
The edit table generator, ZH#EDT. 

The offline recovery utility, ZC#TRC. 

The tape copy routine, ZC#TCP. 


The STATFIL print program, ZC#ZSF 


The offline recovery utility and tape copy routine, which are described in Section 7, are 
provided in the form of object modules that you must link with modules produced by 
the configuration process and other modules to create executable programs. 


The IMS component structure is shown in detailed charts in Appendix D. 


1.4. DTF OR CDM MODE 


IMS accesses your data files through OS/3 data management. OS/3 actually has two 
data management systems, and the one you use depends on your hardware, the way 
your data files are organized, and options you select at system generation. 


Basic data management accesses files in DTF mode. In DTF mode, data files are 
defined by DTF macroinstructions. (You don’t have to write the DTF 
macroinstructions - IMS generates them from your specifications in the configurator 
FILE section.) IMS supports direct access method (DAM), multi-indexed random 
access method (MIRAM), indexed sequential access method (ISAM), and sequential 
access method (SAM) files in DTF mode. IMS also supports indexed random 
access method (IRAM) files but accesses them through MIRAM. You must define 
your IRAM files as MIRAM files in the configurator FILE section. 


Consolidated data management accesses files in CDM mode. In CDM mode, data 
files are defined by CDIB and RIB macroinstructions. (IMS generates CDIB and RIB 
macroinstructions from your specifications in the configurator FILE section.) In CDM 
mode, all disk and diskette data files are organized using MIRAM. You can also use 
sequential tape files in CDM mode. 


If you have a SPERRY UNIVAC System 80, your files are always accessed in CDM 
mode. If you have a SPERRY UNIVAC 90/25, 90/30, or 90/40 System, you can 
use either the DTF mode with DAM, ISAM, MIRAM, and SAM files or the CDM 
mode with MIRAM files. You select DTF mode, CDM mode, or mixed mode for 
your operating system at system generation. 


At configuration, you tell IMS whether to use the DTF or CDM mode with the CDM 
parameter of the IMSCONF jproc. You can’t define both modes in the same IMS 


configuration. 
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For more information about OS/3 data management systems and the DTF and CDM & 
modes, refer to the current versions of: 


@ data management user guide, UP-8068 


@ consolidated data management concepts and facilities user guide/programmer 
reference, UP-8825. 
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2. Communications Support with ICAM 


2.1. GENERAL 


When you use IMS online, it becomes part of a communication system. At one end of 
the system, shown in Figure 2-1, is your configured IMS load module (Section 4). At 
the other end are your terminals. In between are two types of interfaces. The first, the 
communications adapter, is a hardware device that takes messages coming in from 
your network and puts them in a form usable by the operating system and vice versa. 
For a description of the communications adapter, see the communications adapter 
general description, UP-8273 (current version). The other interface, the integrated 
communications access method (ICAM), is the subject of this section. It’s a software 
component that controls the input from and output to the terminals. Because of ICAM, 
IMS is device independent - you can have any arrangement of supported lines and 
terminals without IMS or your action programs being aware of what hardware they're 
working with. 


ICAM is designed to support a number of different types of programs. Because of this, 
ICAM has four different interfaces and two types of networks - dedicated and global. 
You'll be using an interface created for use by IMS, the transaction control interface 
(TCl). You can use it with a dedicated network or a global network. A dedicated 
network supports only your IMS program. All the lines and terminals defined in the 
network definition are dedicated to IMS for the life of a session. A global network can 
be used by your IMS program and other communications user programs at the same 
time. Communications lines can be shared, and terminals can be attached to and 
detached from IMS and other programs during the session. 


2.2. CREATING ICAM 


To use the communication system, you must create an ICAM symbiont that supports 
your network of terminals and that supports the interfaces needed by IMS. You define 
the ICAM support needed with a set of ICAM network definition macros. These macros 
are then run through the SG$PARAM and SG$COMMK procedures of system generation 
(SYSGEN), either when you create your supervisor or in a separate SYSGEN. To create 
your ICAM symbiont, you'll need the current versions of the following manuals: 


= Integrated communications access method (ICAM) concepts and facilities, UP-8194 


Describes how ICAM works. 
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m= «Integrated communications access method (ICAM) network definition and 
operations user guide, UP-8947 








Describes the macros used to configure an ICAM module. 


= System installation user guide/programmer reference, Series 90 environment, 
UP-8074, or System 80 environment, UP-8839 


Describes how to use the ICAM network definition macros to create an ICAM 
symbiont during system generation. 


The ICAM symbiont you create can be either transient or resident. A resident ICAM 
takes up more main storage than does a transient ICAM, but you get the full level of 
support and faster processing. If you have a System 80, you must use a resident ICAM. 
Single-thread IMS systems in a Series 90 environment can use either transient or 
resident ICAM, but a single-thread system supporting unsolicited output must use a 
resident ICAM. With a multithread system, you must use resident ICAM. Table 2-1 
summarizes these requirements. 















IMS 
LOAD MODULE 


IMS runs as a normal 
user job. 





ICAM is the component 
that controls data flow 
to and from the 

remote terminals. 


The communications 
adapter interfaces the 
hardware and the software. 


COMMUNICATIONS 
ADAPTER 





Figure 2-1. IMS and the OS/3 Communications System 
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@ Table 2-1. ICAM Residency Requirements 


Type of Type of 
IMS System ICAM Module 


Single-thread with Resident 
unsolicited output capability 


When you run the ICAM network definition macros through the SGSCOMMK phase of 
system generation, an ICAM object module is created and stored in the system object 
library (SYSOBJ) of the OS/3 release volume (OS/3REL). This object module, called the 
communications control area (CCA), is used for two purposes. When linked by 
SG$COMMK, it becomes part of the ICAM symbiont. Also, a link of the CCA object 
module is done during the first step of the IMSCONF jproc. This allows the configurator 
to determine whether the network is dedicated or global and, if global, to validate the 
LOCAP name against the name specified on the CUP parameter of the NETWORK 
section. 










2.3. NETWORK DEFINITION 


Network definition macros for an ICAM supporting IMS are summarized in Table 2-2. 
For details on generating ICAM, refer to the ICAM network definition and operations 
user guide, UP-8947 (current version). In your network definition, you may also use the 
message processing procedure specifications (MPPS) macros described in the ICAM 
MPPS user guide, UP-8946 (current version). Additional features documented in 
UP-8947 as applying to the transaction control interface, including journaling, are also 
available to you. 


Table 2-2. ICAM Network Definition Macros (Part 1 of 2) 


Generates the control section for IMS requires TYPE=(TCl) for a 
this network dedicated network; TYPE=(GBL,,node) 
for a global network. 


BUFFERS Identifies buffer and activity Required 
request packet requirements 


Creates an interface Required in a global 
between a globai network network; IMS requires 
and IMS TYPE=(TC)). 


& LINE Defines the characteristics of a Must be repeated for every line in the 
line : network 
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SESSION 


DISCFILE 


ENDCCA 


2-4 





Table 2-2. ICAM Network Definition Macros (Part 2 of 2) 


Defines the characteristics of a 
terminal. For resident ICAM, 
also creates output queues 


Sets up a static session path 
between a terminal and IMS or 
between a process file and IMS 


Creates a process file 


TERM macros describing terminals on 
a particular line must immediately 
follow the LINE macro describing that 
line. 


Required for process files and 
static session terminals 


in a global network 


This feature is not supported for 











transient ICAM. It is used only for an 
IMS system using unsolicited 
output. 


Identifies disk files to be used 
for disk buffering 


Required to identify disk buffer file. 
Also identifies output disk queueing 
files, if used 


Marks the end of the network 
definition 


Required 


The ICAM network definition macros basically define three things: the type of ICAM 
interface, your network of lines and terminals, and input/output interfaces. 


Is 


You use the CCA macro to identify a global network or a dedicated network that 
uses the transaction control interface. In a global network, you use the LOCAP 
macro to define a transaction control interface. 


Your network is the arrangement of your terminals for the collection of data going 
to IMS and the distribution of information coming out of it. You must define this 
arrangement for ICAM with LINE and TERM macros. In a global network, you also 
use SESSION macros to define static session terminals — those terminals that are 
attached to IMS during an entire IMS session. 


The input/output requirements are different for a transient or a resident ICAM. 
Figure 2-2 illustrates these interfaces. 


In a transient system, ICAM uses a disk buffer file to hold both input and 
output messages. You define this file with a DISCFILE macro, and you define a 
single network buffer with the BUFFERS macro. 


In a resident system, ICAM stores input messages in main storage buffers and 
output messages in either main storage or a disk queueing file. IMS may 
request that an input message be temporarily stored in a disk buffer file if main 
storage buffer space is not available. You define the disk buffer and disk 
queueing files with DISCFILE macros and a set of network buffers with the 
BUFFERS macro. When you configure an IMS system that supports unsolicited 
output, you also create a special file for unsolicited messages with the PRCS 
macro. In a global network supporting unsolicited output, you must include a 
SESSION macro for each process file. 
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Messages coming into the central 
processor from the terminals are 
put into a main storage or disk 
buffer by ICAM. When IMS 
requests a message from ICAM, 
ICAM takes it from the buffer and 
passes it to IMS. 


When IMS outputs a message, 
ICAM puts the message into the 
disk buffer file (transient ICAM) or 
into a main storage or disk queue 
(resident ICAM). After ICAM 
finishes processing the message, it 
is transmitted to the appropriate 
terminal. 


























r 
| INPUT/OUTPUT | 
i BUFFERS | 


—------ 
{ 





DISK 
QUEUEING 
FILE 
(OPTIONAL FOR 
RESIDENT ICAM) 


COMMUNICATIONS 
ADAPTER 


Figure 2-2. How IMS Inputs and Outputs Messages through ICAM 


2.3.1. Transient Networks for Single-thread IMS 


If you are going to use a transient ICAM to support IMS (available only for Series 90) 


your network must meet the following restrictions: 


It must be a dedicated network. 
You can have no more than two lines in your network. 
Your terminals must be UNISCOPE 100 or UNISCOPE 200. 


Your lines cannot have unattended answering or automatic dialing. 


2-5 


—_ 


= 
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When you code the ICAM network definition macros, you must meet the following 
specifications: 


On the CCA macro, you must specify TYPE=(TCl) to get a transaction control 
interface ICAM module, and you must specify that the module is to be transient 
with TRANSNT=YES. You must also specify FEATURES=(OUTDELV), which is 
needed for shutdown processing in a single-thread system, and SAVE=YES to 
save the CCA object module, which is needed at configuration time. 


The name of the network given in the CCA macro must match the names given on 
the NAME parameter in the NETWORK section of the configurator input and the 
CCA name specified by the CCA parameter of the IMSCONF jproc. The default 
name for both keywords is IMS4. Similarly, the password name specified with the 
PASSWORD operand in the CCA macro must match the password name given in 
the PASSWORD parameter of the NETWORK input to the configurator. 


On the BUFFERS macro, you should declare only one network buffer, the size of 
which should be your maximum message size plus 20 bytes for the message prefix 
header. You specify the buffer size in words. The size must be a multiple of 64. 
Also, if your terminal operators will be using the SHOW command of UNIQUE or if 
any of your user-written action programs use more than one time-fill device 
independent control expression (DICE) sequences in their output messages, then 
you must include the DICE parameter. The DICE specification must equal the 
greatest number of erase-to-end-of-line or end-of-screen DICE instructions in any 
single output message. For the SHOW command, you should specify DICE=2. 


Do not specify DICE=OFF on the TERM macro for any terminal from which you 
intend to use one of the following IMS features: 


UNIQUE 


CHTBL, DITBL, DLMSG, JI, and ZSTAT transaction codes 


ZZCLS and ZZOPN master terminal commands 


Screen format services 


The DISCFILE macro identifies the disk file that ICAM is to use for buffering input 
and output messages. You must allocate and initialize this file through job control 
sometime before the first time you execute online IMS or at the initial start-up 
(Figure 5-1). The name given for the buffer file in the DISCFILE macro must match 
the LFD name given the file when it’s created. The size you specify with the 
MSGSIZE operand (in bytes) must agree with the size you specify (in words) on the 
BUFFERS macro. 


Figure 2-3 shows a network definition for a transient ICAM that supports a 
single-thread IMS system. Figure 2-4 shows the communications network. 




















UP-8364 Rev. 7 SPERRY UNIVAC OS/3 2-7 
IMS SYSTEM SUPPORT FUNCTIONS : 


Explanation 


1 10 16 VY 


CCA TYPE=(TCI), Gives name of network and type of interface 
TRANSNT=YES, Specifies a transient ICAM 
PASSWORD=WILLCAN, Gives the network password 
FEATURES=(OUTDELV), Required for IMS shutdown processing 


SAVE=YES Specifies that CCA object module is 
saved in $Y$OBJ 


BUFFERS 1, Defines a single output buffer 
256, Specifies size of buffer as 256 words 
ARP=9, Gives number of ARPs to be available to ICAM 
DICE=2 Specifies number of DICE functions 


DEVICE=(UNISCOPE), Specifies type of terminals on line 
CALL=5423539, Specifies phone number of line 
TYPE=(2000,SWCH,SYNC) Gives characteristics of line 


ADDR=(28,51), Gives address of terminal 1 


FEATURES=(U100, 960) Identifies terminal as UNISCOPE 100 with 
screen size of 960 characters 


ADDR=(28,52) Gives address of terminal 2 


FEATURES=(U100, 960) Identifies terminal as UNISCOPE 100 with 
screen size of 960 characters 


ADDR=(29,535), Gives address of terminal 3 

FEATURES=(U100, 960) Identifies terminal as UNISCOPE 100 with 
screen size of 960 characters 

ADDR=(29,54), Gives address of terminal 4 


FEATURES=(U100, 960) identifies terminal as UNISCOPE 100 with 
screen size of 960 characters 


TERM ADDR=(29,55), Gives address of terminal 5 


FEATURES=(U100,960) Identifies terminal as UNISCOPE 100 with 
screen size of 960 characters 


TCIDTF DISCFILE MSGSIZE=1024 Identifies file to be used for input buffer. 
Maximum message size is 1024 bytes. 


ENDCCA Ends ICAM definition 





Figure 2-3. Network Definition for Transient ICAM 





UP-8364 Rev. 7 SPERRY UNIVAC OS/3 2-8 


IMS SYSTEM SUPPORT FUNCTIONS 











IMS 


ICAM 


DISK 


BUFFER 
FILE 





COMMUNICATIONS 


ADAPTER 




























TERMINAL 1 
(UNISCOPE 
100) 


TERMINAL 2 
(UNISCOPE 
100) 


TERMINAL 3 
(UNISCOPE 
100) 


TERMINAL 4 
(UNISCOPE 
100) 


TERMINAL 5 
(UNISCOPE 
100) 


Figure 2-4. Sample Communications Network for Transient ICAM 


2.3.2. Resident Networks for Single-thread or Multithread IMS 


If you are going to use a resident ICAM to support IMS, you can have the following 


features: 

= 8A dedicated or global network 

= For System 80, up to eight communication lines, each on a separate single-line 
communications adapter 

= For Series 90, up to 12 communication lines with a single communications adapter, 
or up to 24 lines with two communications adapters 

= Any number of terminals, which may consist of: 


- UNISCOPE 100 Display Terminals 


- UNISCOPE 200 Display Terminals 
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- Directly or remotely connected workstations 
- SPERRY UNIVAC UTS 400 Universal Terminal System terminals 


- SPERRY UNIVAC UTS 10, UTS 20, and UTS 40 Universal Terminal System 
terminals 


- | SPERRY UNIVAC DCT 500 Data Communications Terminals (Series 90 only) 


- SPERRY UNIVAC DCT 1000 Data Communications Terminals in interactive 
mode (Series 90 only) 


- TELETYPE* (TTY) Terminals 
- IBM 3270 Terminal System terminals in interactive mode 


In addition, you can attach these auxiliary devices to those terminals that support 
them: 


- SPERRY UNIVAC 8541 Communications Output Printer (COP) 

- SPERRY UNIVAC Model 800 Terminal Printer (TP) 

- SPERRY UNIVAC 0786 and 0791 Printer Subsystems 

- SPERRY UNIVAC Model 610 Tape Cassette System (TCS) 

- SPERRY UNIVAC 8406 Diskette Subsystem 
m= Unattended answering and automatic dialing 
With a resident ICAM, you have to create more than one network buffer with the 
BUFFERS macro. The number of buffers you'll need and their size depends on the 
amount of activity you anticipate and the sizes of most of your messages. You must 
Create at least one output queue for each terminal. You can have the messages 
associated with a particular queue held in either main storage buffers or a disk queueing 


file. If you have heavy activity, you may want to use disk queueing to save main 
storage space. However, you'll sacrifice some processing speed. 


“Trademark of Teletype Corporation 
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When you code the ICAM network definition macros, you must meet the following 
specifications. 


For a dedicated network, you must specify TYPE=(TCl) on the CCA macro to get a 
transaction control interface ICAM module. (For a global network, you specify 
TYPE=(GBL,,node) and GAWAKE=YES on the CCA macro and TYPE=(TCIl) on 
the LOCAP macro.) The name of the network given on the label of the CCA macro 
must match the names given with the NAME parameter in the NETWORK section 
of the configurator input and the CCA parameter of the IMSCONF jproc. The default 
name for both keywords is IMS4. Similarly, the password name specified with the 
PASSWORD operand in the CCA macro must match the password name given in 
the PASSWORD parameter of the NETWORK input to the configurator. You must 
also specify SAVE=YES to save the CCA object module, which is needed at 
configuration time. If the network definition is for a single-thread IMS system, you 
must specify FEATURES=(OUTDELV) for shutdown processing. You should also 
include TRACEMAX on the FEATURES operand when debugging but not in a 
production environment. 


On the BUFFERS macro, you declare the number of network buffers and their size, 
in words. 


If you use local workstations and have an output message size larger than 2400 
bytes (including control characters), specify the LBL operand on the LINE macros. 
Refer to the OUTSIZE parameter of the configurator ACTION section to calculate 
message size. The default size for the LBL operand is 600 words (2400 bytes). If 
you use screen format services, specify at least 900 words. 


On the TERM macros, you use the LOW operand to create a queue for each 
terminal. (You can also use the HIGH and MEDIUM parameters, but this is not 
usually necessary unless your IMS system supports unsolicited output.) Do not 
specify DICE=OFF for an IBM 3270 terminal or for any terminal from which you 
intend to use one of the following IMS features: 


- UNIQUE 

- CHTBL, DITBL, DLMSG, DLOAD, JI, SWTCH, and ZSTAT transaction codes 

- ZZCLS, ZZOPN, and ZZTST master terminal commands 

- Screen format services 

You use the DISCFILE macro to identify the disk files that ICAM is to use for the 
input buffers and for output disk queueing (if used). You must allocate and initialize 
these files through job control sometime before the first time you execute online 


IMS or at initial start-up (Figure 5-1). The names for the disk files must match the 
names on the LFD statements when the files are created. 


Figure 2-5 shows a dedicated network definition for a resident ICAM module that 
supports a single-thread or multithread IMS system without unsolicited output. Figure 
2-6 shows the communications network. 
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CCA 


TYPE=(TCI), 
PASSWORD=IMC, 
SAVE=YES, 


FEATURES=(OPCOM, OUTDELV) 


BUFFERS 40, 


64, 
5, 
ARP=25 


DEVICE=(UNISCOPE), 
TYPE=(2400,UNAT,SWCH,SYNC), 
1D=04 


ADDR=(28,51), 
FEATURES=(U200, 1920), 


LOW=MAIN 


ADDR=(28,52), 
FEATURES=(U100, 960), 


LOW=MAIN 


ADDR=(29,53), 
FEATURES=(U100, 960), 


LOW=MAIN 


ADDR=(29,54), 
FEATURES=(U100, 960), 


LOW=MAIN 


DEVICE=(TTY,33), 
TYPE=(110,SWCH), 
CALL=5424100 
FEATURES=(TTY), 
LOW=MAIN 





Explanation 


Gives name of network and type of interface 
Gives network password 

Specifies that CCA object module is 

saved in $Y$OBJ 

Allows console cperator communications 
with ICAM and includes module needed 

for shutdown processing in single-thread 


Creates 40 main storage output buffers 

Specifies the size of the buffers as 64 words 
Gives a threshold value of 5 buffers (12.5%) 

Gives the number of ARPs to be available to ICAM 


Specifies type of terminals on line 

Gives characteristics of the line 

Gives port number in communications adapter 
that this line is to use 


Gives address of terminal 1 

Identifies terminal as UNISCOPE 200 with 
screen size of 1920 characters 

Creates queue to be used with main storage 
buffers 


Gives address of terminal 2 

Identifies terminal as UNISCOPE 100 with 
screen size of 960 characters 

Creates queue to be used with 

main storage buffers 


Gives address of terminal 3 

Identifies terminal as UNISCOPE 100 with 
screen size of 960 characters 

Creates low-level queue to be used with 
main storage buffers 


Gives address of terminal 4 
Identifies terminal as UNISCOPE 100 with 
screen size of 960 characters 
Creates queue to be used with 
main storage buffers 

Specifies type of terminal on line 
Gives characteristics of line 
Specifies phone number of line 
Identifies terminal as TELETYPE 
Creates queue to be used with main 
storage buffers 





Figure 2-5. Network Definition for Resident ICAM (Part 1 of 2) 
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Explanation 


LINE DEVICE=CUNISCOPE), Specifies type of terminals on line 
TYPE=(2400,SWCH, SYNC ,UNAT) Gives characteristics of line 
ID=06 


TERM ADDR=(29,51), Gives address of terminal 6 
FEATURES=(U400, 1929), Identifies terminal as Universal Terminal 
System 400 with a screen size of 1920 
characters 
LOW=MAIN Creates queue to be used with 
main storage buffers 
TERM ADDR=(29,52), Gives address of terminal 7 
FEATURES=(U400, 1920), Identifies terminal as Universal Terminal 
System 400 with a screen size of 1920 
characters 
LOW=MAIN Creates queue to be used with 
main storage buffers 
TCIDTF DISCFILE MSGSIZE=1920 Identifies file to be used for input buffer; 
maximum message size is 1920 bytes. 


ENDCCA Ends ICAM definition 





Figure 2-5. Network Definition for Resident ICAM (Part 2 of 2) 
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Figure 2-6. Sample Dedicated Communications Network for Resident ICAM 
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2.3.2.1. Network Definition for a System Supporting Unsolicited Output 


If you configure an IMS system that supports unsolicited output, you must create a 
resident ICAM module, regardless of whether your IMS system is single-thread or 
multithread. You must create an ICAM module that supports unsolicited output if you 
want to use the SEND function, the SWTCH transaction, the ZZTST terminal command, 
continuous output, or downline loading. 


In addition to the requirements already mentioned for a resident ICAM, you must meet 
the following additional specifications in your ICAM network definition: 


m Using the HIGH, MEDIUM, and LOW parameters on the TERM macros, you must 
create three output message queues for each terminal. ICAM will output all the 
messages in the high-level queue before it begins to transmit messages from the 
medium-level queue, then the low-level queue. We recommend that you have the 
messages for the low-level queue kept on disk to keep the size of your ICAM 
module down. 


m Using the PRCS macro, you must create a special queue called a process file. 
Unsolicited messages are kept buffered until the end of the action. We recommend 
that you create an additional disk buffer file for this purpose. You should create 
more than one process file for a multithread IMS system in which multiple actions 
use unsolicited output concurrently. 


m= You must specify FEATURES=(OUTDELV) on the CCA macro for a multithread 
system supporting continuous output. (It is always required for a single-thread 
system.) 


Figure 2-7 shows the network definition macros for a resident ICAM module that 
supports an IMS system with unsolicited and continuous output. It defines the 
communications network shown in Figure 2-8. The network definition is the same as 
the example in Figure 2-5, except that a communications output printer, a terminal 
printer, and specifications required for unsolicited and continuous output have been 
added. The macros and parameters shown in the previous example are shaded; the 
new specifications are unshaded. 
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Explanation 


HIGH=MAIN, Creates high-level queue to be used with 
main storage buffers 

MEDIUM=MAIN, Creates medium-level queue to be used with 
main storage buffers 

LOW=DQFILE1 Creates low-level queue to be used with 
disk file buffer 





HIGH=MAIN, Creates high-level queue to be used with 
main storage buffers 

MEDIUM=MAIN, Creates medium-level queue to be used with 
main storage buffers 

LOW=DQFILE1 Creates low-level queue to be used with 
disk file buffer 


HIGH=MAIN, Creates high-level queue to be used with 
main storage buffers 

MEDIUM=MAIN, Creates medium-level queue to be used with 
main storage buffers 

LOW=DQFILE1 Creates low-level queue to be used with 
disk file buffer 


AUX1=(COP,73), Terminal has communications output printer. 
HIGH=MAIN, Creates high-level queue to be used with 
main storage buffers 


MEDIUM=MAIN, Creates medium-level queue to be used with 


main storage buffers 
LOW=DQFILE1 Creates low-level queue to be used with 
disk file buffers 





Figure 2-7. Network Definition for ICAM Supporting Unsolicited Output (Part 1 of 2) 
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Explanation 


HIGH=MAIN, Creates high-level queue to be used with 
main storage buffers 

MEDIUM=MAIN, Creates medium-level queue to be used with 
main storage buffers 

LOW=DQFILE1 Creates low-level queue to be used with 
disk file buffer 


HIGH=MAIN, Creates high-level queue to be used with 
main storage buffers 
MEDIUM=MAIN, Creates medium-level queue to be used with 
main storage buffers 
LOW=DQFILE1 Creates low-level queue to be used with 
© disk file buffers 


AUX1=TP,77) Terminat has terminal printer. 

HIGH=MAIN, Creates high-level queue to be used with 
main storage buffers 

MEDIUM=MAIN, Creates medium-level queue to be used with 
main storage buffers 

LOW=DQFILE1 Creates low-level queue to be used with 
disk file buffers 


POO1 PRCS LOW=DQFILE2 Creates a single-level process file to be 
used with disk file buffers 

DQFILE1 DISCFILE FILEDIV=8 Identifies file to be used for output disk 
file buffers 

DQFILE2 DISCFILE FILEDIV=8 Identifies file to be used with process file 


for unsolicited output 


Ends ICAM definition 





Figure 2-7. Network Definition for ICAM Supporting Unsolicited Output (Part 2 of 2) 
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Figure 2-8. Sample Communications Network for ICAM Supporting Unsolicited Output 


2.3.2.2. Network Definition for a Global Network 


You can use a global network for more than one IMS program and for other 
communications user programs that use the ICAM standard interface. A global network 
requires a resident ICAM. To use a global network, you must include the CUP 
parameter in the configurator NETWORK section. 


You write a network definition for a global network the same way as for a dedicated 
network, with several modifications: 


= On the CCA macro, you must specify TYPE=(GBL,,node) to identify a global 
network and to name the computer system using the network. You must also 
specify GAWAKE=YES to allow dynamic sessions. 


m= You use the LOCAP macro to identify your online IMS program as a local 
application. The label on the LOCAP macro must match the CUP parameter 
specification in the configurator NETWORK section. You must specify TYPE=(TCI) 
to get a transaction control interface. This specification is available to IMS users 
only and is not documented in ICAM manuals. 
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€ = You use SESSION macros to identify static session terminals. Static session 
terminals are always attached to your IMS program when it is online. Terminals 
that you identify with TERM macros but do not name in SESSION macros are 
dynamic session terminals. Dynamic session terminals can be attached to and 
detached from your IMS program (or any other program using the global network 
definition) while your program is running. For information on attaching and 
detaching dynamic terminals, refer to the IMS terminal users guide, UP-9208 
(current version). 





You also use SESSION macros to identify one or more process files in static 
sessions with IMS. This is required for an IMS system with unsolicited output. 


Figure 2-9 shows the network definition macros for the global communications network 
shown in Figure 2-10. The network definition is the same as Figure 2-7, except for the 


global specifications. The macros and parameters previously shown are shaded; the 
new entries are unshaded. 


Explanation 


Identifies a global network and the local node 


GAWAKE=YES Allows dynamic sessions 


LOCAP TYPE=(TCI) Gives name of IMS program 


and type of interface 





Figure 2-9. Global Network Definition (Part 1 of 2) 
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SESSION EU1=CIMS9) ,EU2=(TRM1) 
SESSION EU1=C(IMS9) EU2=(TRM2) 
SESSION EU1=CIMS9) , EU2=(TRM3) 
SESSION EU1=(IMS9) ,EU2=( TRM4) 
SESSION EU1=C(IMS9) , EU2=(P001) 





Explanation 


Identifies TRM1 as a static session terminal 
Identifies TRM2 as a static session terminal 
Identifies TRM3 as a static session terminal 
Identifies TRM4 as a static session terminal 


tdentifies POO1 as a static process file 





Figure 2-9. Global Network Definition (Part 2 of 2) 
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Figure 2-10. Sample Global Communications Network 


2.3.2.3. Network Definition for a Global Network using Local and Remote 
Workstations 


Figures 2-11 and 2-12 illustrate a global network that uses three local workstations 
and one remote workstation. Notice in the network definition that there is only one local 
workstation per line. The remote workstation has a screen bypass device that is 
defined to ICAM as a separate terminal. Both terminals are on one line and form one 


polling group. 


This network supports three other applications in addition to IMS, through the [CAM 
standard interface. One of the local workstations, TRM1, is defined in a SESSION macro 
as a static terminal for CUPP and is not available to IMS. The other three workstations 
are dynamic terminals and can be attached to IMS or any of the other applications. 


Note that this network does not support unsolicited or continuous output. To support 
unsolicited and continuous output, it would require the FEATURES=(OUTDELV) operand 
on the CCA macro, three queues for each terminal, and a process file in static session 
with IMS. 
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CCA TYPE=(GBL,,A), 
SAVE=YES, 
FEATURES=(OPCOM), 
GAWAKE=YES 

BUFFERS 20,512,1,ARP=42, 
STAT=YES 


LOCAP TYPE=(TCI) 

LOCAP TYPE=(STDMCP) ,LOW=MAIN 
LOCAP TYPE=(STDMCP),LOW=MAIN 
LOCAP TYPE=(STDMCP),LOW=MAIN 
LINE DEVICE=(LWS),STATS=YES 


TERM FEATURES=(LWS) ,ADDR=(315), 
LOW=MAIN,HIGH=MAIN, 
INPUT=PRF 1 


DEVICE=(LWS) ,STATS=YES, 
LBL=1000 


FEATURES=(LWS) , ADDR=(316), 
LOW=MAIN, HIGH=MAIN 


LINE DEVICE=(LWS),STATS=YES, 
LBL=1000 


TERM FEATURES=(LWS) ,ADDR=(317), 
LOW=MAIN,HIGH=MAIN 
PGROUP PGID=28 


LINE DEVICE=(RWS), 
TYPE=(9600, SWCH, SYNC) 
ID=9 
FEATURES=(U40,,,PRIMARY), 
ADDR=(28,51),LOW=MAIN, 
HIGH=MAIN, AUX1=(COP, 73) 


FEATURES=(U40,,,SECONDARY), 
ADDR=(28,52),LOW=MAIN, 
HIGH=MAIN, AUX1=(COP, 73) 


PRCS LOW=MAIN 

SESSION EU1=(CUPP),EU2=(TRM1) 
SESSION EU1=(PRF1),EU2=(CUPP ) 
ENDCCA 








Explanation 


Names IMS program using TCI interface 
Identifies an application using the standard interface 


Defines type of terminal on LNE1 as local workstation 


Gives address of terminal and creates low and 
high queues. This terminal is not available 
to IMS. (See SESSION macro.) 


Defines type of terminal on LNE2 as local 
workstation and gives line buffer length of 
1000 words 


Gives address of terminal and creates low and 
high queues. TRM2, TRM3, and TRM4 are available 
to IMS. 





Identifies polling group 


Specifies that communications line LNE4 uses remote 


workstation protocol 


Specifies that the remote workstation is the 
primary screen of a UTS 40. Identifies address 
of workstation in polling group 

Specifies that the remote workstation is a 

UTS 40 screen bypass device. Identifies address 
of screen bypass device in polling group 


Identifies TRM1 as a static session terminal for CUPP 
Identifies PRF1 as a static process file for CUPP 


Figure 2-11. Network Definition for Global ICAM with Workstations 
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Figure 2-12. Sample Communications Network for Global ICAM with Workstations 


2.3.2.4. Network Definition for a Global Network Supporting Distributed 
Data Processing 


Figures 2-13 and 2-14 illustrate a global network that supports distributed data 
processing. The network contains two computers. Either computer can route 
transactions to the other for processing or process transactions it receives from the 
other. Figure 2-13 illustrates the definition of the primary computer, and Figure 2-14 
illustrates the definition of the secondary computer. 
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Explanation 


10 16 


CCA TYPE=(GBL,,NODA), 

FEATURES=(OUTDELV,OPCOM), 

PASSWORD=IMSNETO1, 

GAWAKE=YES, 

SAVE=YES, 

DCA=YES Indicates support of distributed communications 
architecture 

BUFFERS 100, 

64, 

1 t 

ARP=50, 

LINKPAK=(50,80, 19) Specifies the number of 80-word link buffers used 
with distributed data processing and the 
threshold value 

TYPE=(TCI), 

LOW=MAIN, 

MEDIUM=MAIN, 

HIGH=MAIN 

DEVICE=(UNISCOPE), 

TYPE=(2400,SWCH, SYNC) 

CALL=3589 Specifies the telephone number used to dial a 
terminal 





ADDR=(28,51), 
FEATURES=(U100,960), 
HIGH=MAIN, 
MEDIUM=MAIN, 
LOW=MAIN, 
INPUT=C(YES) Creates an input message queue for this terminal 
ADDR=(28,52) ,X 
FEATURES=(U100,960), 
HIGH=MAIN, 
MEDIUM=MAIN, 
LOW=MAIN, 
INPUT=C(YES) 


ADDR=(29,53), 
FEATURES=(U100, 960), 
HIGH=MAIN, 
MEDIUM=MAIN, 
LOW=MAIN, 
INPUT=(YES) 





Figure 2-13. Network Definition for Global ICAM Supporting Distributed Data Procesing (Primary Computer) (Part 1 of 3) 
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10 16 


TRM4 TERM ADDR=(29,54), 
FEATURES=(U100,960), 
HIGH=MAIN, 
MEDIUM=MAIN, 
LOW=MAIN, 
INPUT=(YES) 

LINE DEVICE=(UNISCOPE), 
TYPE=(9600,SYNC), 
ID=15 

TERM ADDR=(28,51), 
FEATURES=(U200, 1920) 
HIGH=MAIN, 
MEDIUM=MAIN, 
LOW=MAIN, 
INPUT=(YES) 


PRCS LOW=MAIN 


SESSION EU1=C(IMS9), 


EU2=(P001) 


VLINE DEVICE=(ABM,PRIMARY), 


ID=10, 


TYPE=(9600,FLDQ), 
CMADDR=3, 


RSPADDR=1 


Explanation 


Creates a process file for temporarily storing 
messages 


Specifies the name of a local end user defined in 
the label of a LOCAP macro 


Specifies the name of a local end user defined in 
the label of a PRCS macro 


Specifies this line is used for communication 
between two OS/3 systems and that this processor 
is the primary computer 

Identifies the line number of the single line 


communications adapter 
Specifies the line speed 
Specifies the universal data link control frame 


level address used to transmit commands and 
receive responses 


Specifies the universal data link control frame 
level address used to transmit responses and 


receive commands 





Figure 2-13. Network Definition for Global ICAM Supporting Distributed Data Procesing (Primary Computer) (Part 2 of 3) 
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Explanation 


LPORT EU1=IMS9, LPORT creates a remote session entry table for 
each single logical port, EU1= specifies the label 
of the LOCAP macro defining the local end user. 

EU2=IMSR, Specifies the label of the LOCAP macro defining 
the remote end user 

USERTP=STDMCP, Indicates DDP operates through ICAM’s standard 
interface 

CATP=C, Indicates error recovery by port flow control and 
provision of assurance units by the DDP interface 

LINE=V3N1, X The label of the VLINE macro 

REMOTE=NODB, xX The name of the destination node 

PORT=4, The port number 

RWNOW=2 The port window level 

IMSR LOCAP TYPE=(STDMCP), 

LOW=MAIN, 

MEDIUM=MAIN, 

HIGH=MAIN, 

REMOTE=NODB The name of the remote computer node where this 
locap file is located 





ENDCCA 





Figure 2-13. Network Definition for Global ICAM Supporting Distributed Data Procesing (Primary Computer) (Part 3 of 3) 
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2-25 








CCA 


Explanation 


TYPE=(GBL, ,NODB), 
FEATURES=(OUTDELV, OPCOM), 
PASSWORD=IMSNETO1, 
GAWAKE=YES, 

SAVE=YES, 

DCA=YES 


BUFFERS 100, 


Figure 2-14. 


64, 

1, 

ARP=50, 
LINKPAK=(50,80, 10) 
TYPE=(TCI), 
LOW=MAIN, 
MEDIUM=MAIN, 
HIGH=MAIN 


DEVICE=(UNISCOPE), 
TYPE=(2400,SYNC,SWCH,UNAT), 
CALL=4408, 

ID=12 


ADDR=(28,51), 
FEATURES=(U400, 1920), 
HIGH=MAIN, 
MEDIUM=MAIN, 
LOW=MAIN, 

INPUT=(YES) 


ADDR=(28,52), 
FEATURES=(U400, 1920), 
HIGH=MAIN, 
MEDIUM=MAIN, 
LOW=MAIN, 

INPUT=(YES) 


ADOR=(28,53), 
FEATURES=(U400, 1920), 
HIGH=MAIN, 
MEDIUM=MAIN, 
LOW=MAIN, 

INPUT=(YES) 


ADDR=(28,54), 
FEATURES=(U400, 1920), 
HIGH=MAIN, 
MEDIUM=MAIN, 
LOW=MAIN, 

INPUT=(YES) 





Network Definition for Global ICAM Supporting Distributed Data Processing (Secondary Computer) 


(Part 1 of 2) 
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LNE6 


IMS9 


LINE DEVICE=(UNISCOPE), 
TYPE=(9600,SYNC), 
1D=15 

TERM ADDR=(28,51), 
FEATURES=(U400, 1920), 
HIGH=MAIN, 
MEDIUM=MAIN, 
LOW=MAIN, 
INPUT=(YES) 

PRCS LOW=MAIN 

SESSION EU1=(IMSR), 
EU2=(P001) 


VLINE DEVICE=(ABM,PRIMARY), 
1D=05, 
TYPE=(9600,FLDQ), 
CMADDR=1, 


RSPADDR=3 


EU1=IMSR, 


EU2=IMS9, 


USERTP=STDMCP, 
CATP=C, 
LINE=V3N2, 
REMOTE=NODA, 
PORT=4, 
RWNDW=2 


LOCAP TYPE=(STDMCP), 
LOW=MAIN, 
MEDIUM=MAIN, 
HIGH=MAIN, 
REMOTE=NODA 


ENDCCA 





Explanation 


Specifies universal data link control frame level 
address used to transmit commands and receive 
responses 

Specifies universal data link control frame level 
address used to transmit responses and receive 
commands 

The label of the LOCAP macro defining the local 
end user 


The label of the LOCAP rnacro defining the remote 


end user 


The Jabel of the VLINE macro 
The name of the destination node 


The name of the remote computer node where this 
locap file is located 





Figure 2-14. Network Definition for Global CAM Supporting Distributed Data Processing (Secondary Computer) 


(Part 2 of 2) 
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2.4. COMMUNICATIONS MESSAGE FORMAT CONTROL 


Several methods are available to the action programmer for controlling the formatting of 
input and output messages at remote terminals. The most convenient of these are 
device-independent control expressions (DICE) and field control characters (FCCs). 


DICE and FCC sequences in message text are detected and processed by ICAM. If you 
specify editing of input messages to the configurator (EDIT and FCCEDIT keyword 
parameters in the ACTION section), DICE and FCC sequences are deleted from input 
messages before they are passed to your action program. 


2.4.1. DICE Sequences 


The device-independent control expression (DICE) is a 4-character hexadecimal sequence 
inserted into the text of an output message to control positioning and functions on 
remote terminal devices. DICE functions provided by ICAM include carriage return, 
cursor positioning, forms control, line control, tab control, line feed, and screen erasure. 
They are documented in the current versions of the IMS action programming manuals, 
with examples of their use. 


2.4.2. Field Control Characters 


If you have Universal Terminal System (UTS) terminals or local workstations in your 
network, you can use field control character (FCC) sequences in your action program or 
your UTS program. The FCC is a 5-byte hexadecimal sequence that begins with the 
character US (hexadecimal 1F). It is similar to DICE but provides additional control over 
data formatting. With FCC sequences in the output message, your program can highlight 
selected elements of data to automatically reject the wrong type of data or prevent the 
entry or change of any data in a given field. You may also use FCCs to specify that 
only changed or variable data be transmitted. 


For details on the use of FCC sequences, refer to the appropriate reference manual for 
your terminal system. 
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3. Pre-Online Processing 


3.1. GENERAL 


The term pre-online processing refers to all of the IMS utilities and procedures that you 
may execute beforehand to define your particular online operating environment. The 
term excludes other activities such as creating the conventional ISAM, MIRAM, SAM, or 
DAM files that are to be processed by your IMS application: These you create offline. It 
also does not include the programming necessary to produce your COBOL, BAL, or RPG 
Il action programs. 


Pre-online processing includes the following: 


= = =allocating and initializing the named record (NAMEREC) file, using the IMS utility 
program, ZP#NRU; 


= password definition, using the same NAMEREC file utility, ZP#NRU; 
= data definition, using the data definition processor (DT3DF); 

= edit table generation, using the IMS utility, ZH#EDT; and 

™ ~ configuring the online IMS system. 


The NAMEREC file must be initialized before any other pre-online processing can take 
place, because all of the IMS processors, including the configurator, contribute records 
to this file. You initialize the file either by executing the NAMEREC file utility or as part 
of the configuration process, in which case you must configure before doing any other 
pre-online processing. 


The other pre-online processing functions may be accomplished in any convenient order, 
and all except configuration are optional, depending on your individual requirements. 
Password definition is available only for UNIQUE. Data definition is required only if you 
use UNIQUE or if your action programs access defined files. Edit table generation is not 
applicable to UNIQUE and is optional for user action programs. 


Initialization of the NAMEREC file and password definition are described in this section 
and configuration in Section 4. Data definition is described in the IMS data definition and 
UNIQUE user guide, UP-9209 (current version), and edit table generation is discussed in 
the IMS action programming manuals. 
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3.2. THE NAMED RECORD FILE UTILITY 

You may use the named record (NAMEREC) file utility, ZP#NRU, to: 

m initialize the NAMEREC file; 

mw define new password definition records and change existing passwords; 

a delete data definition records and password records; and 

m list the contents of the NAMEREC file. 

The NAMEREC file can be initialized at configuration time with the INIT parameter of the 
IMSCONF job control procedure (jproc). IMSCONF calls in the ZP#NRU program to 
initialize, or scratch and reinitialize, the NAMEREC file, but it does not permit password 
definition or produce a listing or entries in the NAMEREC file. If you initialize the 
NAMEREC file at configuration, however, you can still execute the ZP#NRU utility to 
define passwords or to obtain a listing of records in the file. 

3.2.1. Initializing the NAMEREC File (INIT) 

Initializing the NAMEREC file with the ZP#NRU utility allows you to: 


m define the exact location on disk where the file is to reside (this is not possible 
when the NAMEREC file is initialized by IMSCONF); and 


™ process data definitions, password definitions, and edit tables before configuration. 


To initialize the NAMEREC file with the ZP#NRU utility, you must include the INIT 
function parameter in the job control stream. Its format is: 


INIT BLKSZE=nnnnn 
where: 


INIT 
Is the function parameter and must occupy columns 1-4. 


BLKSZE=nnnnn 
Defines the block size of the NAMEREC file in decimal bytes ranging from 
1024 to 12,800. This specification must be a multiple of 256 and must not 
exceed the track size of the disk subsystem on which the NAMEREC file 
resides. 
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The job stream in Figure 3-1 illustrates the execution of the ZP#NRU program to 
allocate and initialize the NAMEREC file. The file name in the LFD statement must be 
ISAMNRF. The EXT statement defines the file type - MIRAM (MI) for a CDM system, 
ISAM (IS) for a DTF system - and specifies the size of the file in either cylinders or 
blocks. For a discussion on determining the size needed for the NAMEREC file, see 
C.2.2. If you are initializing a previously allocated NAMEREC file, you should omit the 
EXT statement; however, you must specify INIT on the LFD statement. Omission of the 
INIT parameter causes ZP#NRU to abnormally terminate with an error code of 62. 


// JOB NAMEREC 

// DVC 26 // LFD PRNTR 

// DVC 5@ // VOL DS1234 

// EXT 189,C,,CYL,20 

// LBL NAMEREC // LFD ISAMNRF,, INIT 


// EXEC ZP#NRU 

/$ 

INIT BLKSZE=6144 
/* 

/& 

// FIN 





NOTE: 
@) In a CDM system, replace IS with MI. 


Figure 3-1. Sample Control Stream to Allocate and Initialize the NAMEREC File 


After initializing the NAMEREC file for its first use in your pre-online processing, you 
may need to scratch it and reinitialize it. This becomes necessary if execution of the 
configurator, data definition processor, edit table generator, or a password run of the 
NAMEREC utility is abnormally terminated, or if you have any other reason to suspect 
that the file is compromised. You can scratch and reinitialize the NAMEREC file with the 
INIT parameter of the configurator jproc, IMSCONF, or with the ZP#NRU utility and the 
SCR job control statement. After you reinitialize the NAMEREC file, you must rerun all 
pre-online processors. 


Figure 3-2 shows the job control statements needed to scratch and reinitialize an 
existing NAMEREC file with the ZP#NRU utility and the SCR job control statement. Two 
device assignment sets are needed for the NAMEREC file: one to deallocate; the other 
to reallocate and reinitialize it. You can use any file name except ISAMNRF in the LFD 
statement for the file that is to be scratched; you must use the same file name in the 
SCR statement. The file identifier in the LBL statement must agree with the LBL name 
assigned to the file when it was originally allocated. 
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// 
// 
// 
// 
// 
// 
// 


// 
// 
/$ 
INIT BLKSZE=6144 
/* 
/& 


NOTE: 


JOB 
DvVC 
DVC 
LFD 
SCR 
DVC 
EXT 
LBL 


NEWNMRC 

20 // LFD PRNTR 

5@ // VOL DS1234 // LBL NAMEREC 
SCRNMRC 

SCRNMRC 

50 // VOL DS1234 

I9D,C,,CYL,20 

NAMEREC // LED ISAMNRF,,INIT 


EXEC ZP#NRU 





@ In a CDM system, replace IS with Mi. 


Figure 3-2. Sample Control Stream to Scratch and Reinitialize a Compromised NAMEREC File 


3.2.2. Listing the Records in the NAMEREC File (LIST) 


The LIST parameter of ZP#NRU lists the keys of all records in the NAMEREC file. The 
first byte of the key is printed as a hexadecimal value and indicates record type. 


Possible values are: 


C1 Configuration Internal Action Control Record 


C3 
C6 
C9 
D3 
D7 


D9 


E2 


E3 


Created during configuration. 


Configuration Control Record or Configurator Error Control Record 


Configurator Internal File Control Table 


Configurator CCA Control Record 


Configurator Internal Language/Lexicon Control Record 


Configurator Internal Program Record 


Restart Record 


Created during configuration and updated during multithread shutdown; 


used during restart. 


Start Record 


Created during configuration; used during start-up. 


Configurator Internal Terminal/Transaction Record 
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F1 


FA 


FC 


FD 


FE 


Dummy Record 
Created by named record file utility. 
Expanded Editing Record 
Created by edit table generator. 
Password Definition Record 
Created by named record file utility or data definition processor. 
Data Definition Record 
Created by data definition processor. 
UNIQUE Lexicon Record 


Created during configuration. 


In addition, the configurator may create other records for internal use. 


For configuration records, bytes 2, 3, and 4 of the key specify the control table name; 


they're p 
TCT 
FCT 
PCT 
ACT 
TRN 
LCP 


The rem 


rinted as alphanumeric characters. Possible values are: 
Terminal Control Table 
File Control Table 
Program Control Table 
Action Control Table 
Transaction Control Table 
Locap Control Table 


aining four bytes of the key contain the binary representation of n in the 


specification CONFID=n. (See 4.3.1.2.) They‘re printed as blanks. 


Configuration records such as D9 and E2 are printed in sets depending on the number 
of configurations in the NAMEREC file. For each unique CONFID=n specified to the 


configura 
the NAM 


tor, a set of D9, E2, and other internal configuration records are generated into 
EREC file. 


The format of the LIST function parameter is: 


LIST 


The LIST parameter must be coded in columns 1-4. See Figure 3-3 for an illustration of 


LIST spe 


cified in a password definition run of the ZP#NRU utility. 
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3.2.3. Password Definition 


The password definition process provides security for your data files when you use 
UNIQUE. Terminal operators using UNIQUE must enter the appropriate password with 
the OPEN command to gain access to a defined file or subfile, and you can change this 
password as frequently as you choose. The password facility is not available to user 
action programs. 


You can define passwords in two different ways during pre-online processing: 


1. Using the PASSWORD option in the DEFINED FILE and SUBFILE statements in the 
data definition. This allows all terminal operators to access the defined file using 
the defined file name or subfile name. 


2. Executing the NAMEREC file utility with the PASSWORD function parameter. This 
allows you to restrict access to specific terminals and to change passwords. 


The password capability of the data definition processor is limited. You either include 
the PASSWORD option or you omit it. When you include PASSWORD, all terminals can 
access the defined file or subfile by its actual name (but you can void the use of this 
name with the NAMEREC utility). When you omit PASSWORD, no terminals can access 
the file until you define a password with the NAMEREC utility. The PASSWORD option 
of the data definition processor is discussed in the IMS data definition and UNIQUE user 
guide, UP-9209 (current version). 


When you use the NAMEREC utility to define passwords, you have several options: 
1. You can allow a password to be entered from all terminals. 
2. You can restrict access to specific terminals. 


3. You can void a password defined in the data definition or in a previous run of the 
NAMEREC utility. 


4. You can define multiple passwords for the same defined file or subfile, restricting 
each to the desired terminals. 


Because a defined file or subfile can have more than one password, when you want to 
change passwords you should delete or void the old password in addition to defining a 
new one. If you used the PASSWORD option in the data and you now want to restrict 
access to specific terminals, you must first delete or void the old password and then 
define a new password, restricting its use to the desired terminals. 
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3.2.3.1. PASSWORD Function Parameter (PASSWORD) 


To define passwords with the NAMEREC file utility, place the PASSWORD function 
parameter in the job control stream, in the following form: 


PASSWORD PID=password-id DDN=data-def-rec-name FN=def- filename 


TID=f ALL 
NONE 


a (al tal 


where: 


PASSWORD 
Is the function parameter and must be coded in columns 1-8. 


PID=password- id 


Designates the 1- to 7-character password name, the first character of which 
must be alphabetic. 


DDN=data-def-rec-name 


Identifies the data definition record in which the defined file or subfile this 
password accesses is defined. The name of the data definition record is the 
same as the defined file name. 


FN=def - filename 
Identifies the defined file or subfile to which this password authorizes access. 


TID=ALL 


Stipulates that all terminals configured in this IMS communications network are 
authorized to submit the password name for access to the file. 


TID=NONE 


Stipulates that no terminal is authorized to submit the password name. Use 
this specification to delete a previously authorized password. You can also 
delete passwords with the DELETE parameter (3.2.4). 


aaa | cl aaa 


Identifies those terminals that are authorized to submit this password. These 
terminal names must match terminal names specified in the ICAM network 
definition. Terminal names may be one to four characters in length. If less than 
four characters, terminal names must be delimited by either commas or 
spaces; if exactly four characters, they may be coded with or without 
delimiters (commas or spaces). More than one blank character indicates the 


end of the terminal definitions, unless a nonblank character is coded in column 
72. 
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You must include all keyword parameters, whether a password is to be added or 
changed. 


Except that the function parameter PASSWORD must be coded in column 1-8, the 
parameters may be punched freeform. A nonblank character in column 72 indicates 
continuation, and continuation cards may start in any column except column 1. 
Sequence numbers in columns 73-80 are optional. You can define any number of 
passwords in a single execution. 


Figure 3-3 illustrates the execution of the ZP#NRU utility to define passwords and to list 
the keys of records in the NAMEREC file. 


// JOB IMPAS 

// DVC 20 // LFD PRNTR 

// DVC 50 // VOL DS9999 //LBL NAMEREC,DS9999 // LFD ISAMNRF 
// EXEC ZP#NRU 

/$ 

PASSWORD PID=WARES DDN=WARE FN=PRODFIL TID=ALL 


PASSWORD PID=PAYROL DDN=TAXRCRD FN=PAYFILE TID=T1,T2,1T3 
PASSWORD PID=CUST DDN=CUSTM FN=CUSTFIL TID=T001T002TOO3TOO4TOO5 
T007T008T009TO10T011TO12TO13TO14TO15 


LIST 
/* 

/& 

// FIN 





Figure 3-3. Sample Control Stream for Password Definition and Listing of Records in the NAMEREC File 


The first PASSWORD statement assigns the password WARES to the defined file 
PRODFIL and specifies that all terminals may have access to this file. The second 
statement specifies that only terminals T1, T2, and T3 are authorized to access the 
defined file PAYFILE by submitting the password PAYROL. The third statement shows 
the splitting of terminal identifiers on two cards. Notice that the terminal names are four 
characters in length and have no delimiters; they could optionally have been separated 
by commas or spaces. 


To void an existing password definition record, whether it was created and placed in 
the NAMEREC file by the data definition processor or by a previous execution of the 
ZP#NRU utility, you can employ the TID=NONE option in a subsequent run (or use the 
DELETE function parameter). To change an existing password, you can use the 
TID=NONE option to delete the previous password and establish the new password 
with another specification of the PASSWORD function parameter. Notice, in Figure 3-4, 
that both may be done in the same execution of ZP#NRU. 
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// JOB CHGPAS 

// DVC 20 // LFD PRNTR 

// DVC 5@ // VOL DS9999 // LBL NAMEREC,0S9999 // LFD ISAMNRF 
// EXEC ZP#NRU 

/$ 


PASSWORD PID=WARES TID=NONE DDN=WARE FN=PRODFIL 
PASSWORD PID=SESAME DDN=WARE FN=PRODFIL TID=ALL 
/* 

/& 

// FIN 





Figure 3-4. Sample Control Stream for Changing an Established Password 


Figure 3-4 illustrates the method of changing an existing password; it voids the 
password name, WARES, assumed to have been previously established for the defined 
file PRODFIL by the example in Figure 3-3 and establishes the new password SESAME 
for the same file. 


3.2.4. Deleting Data Definition and Password Records (DELETE) 


The DELETE function parameter logically deletes data definition and password records 
from the NAMEREC file and allows you to physically delete these records using an OS/3 
utility program, without reformatting the NAMEREC file. To delete data definition and 
password records with the NAMEREC file utility, include the DELETE function parameter 
in your job control stream in the following format: 


DELETE eich [,----+,name-n] 
PSW=name-1 [,....,name-n]}. 


where: 


DELETE 
Is the function parameter and must be coded in columns 1 through 6. 


DDR=name-1 [,...-,name-n] 
Specifies the data definition records to be deleted. Record names should not 
exceed seven characters. 


PSW=name-1 [,....,name-n] 
Specifies the password names to be deleted. Record names should not exceed 
seven characters. 


Record names can be continued on succeeding cards. A non-blank character in column 
72 indicates continuation, and continuation cards may begin in any column except 
column 1. 
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The NAMEREC file utility logically deletes records by placing a hexadecimal FF in the 
first byte of data (position 8) of the record. To physically delete the records, you should 
use the deletion option of the utility disk-to-disk (UDD) data utility. You can restore a 
password record that was incorrectly deleted by using the NAMEREC utility PASSWORD 
parameter. 


Figure 3-5 illustrates the execution of the ZP#NRU utility which deletes a password and 
lists the keys of the records in the NAMEREC file. 


// JOB DELPS 

// DVC 20 // LFD PRNTR 

// OVC 5@ //VOL DS999 //LBL NAMEREC,DS999 //LFD ISAMNRF 
// EXEC ZP#NRU 

/$ 


DELETE PSW=WARES 
LIST 

/* 

/& 





Figure 3-5. Sample Control Stream for Password Deletion and Listing of Records in the NAMEREC File 


The DELETE statement deletes the password WARES. The LIST statement lists the 
keys of all records in the NAMEREC file. 


3.2.5. NAMEREC Utility Error Processing 


When the ZP#NRU utility encounters a password definition input error, a message is 
printed and processing continues. Valid passwords are written to the NAMEREC file; 
only the password definitions containing errors must be resubmitted. I/O errors cause 
program termination; an error message is also printed. 


The NAMEREC utility also generates error messages when you use the DELETE 
parameter to delete data definition and password records. 


See Table F-1 in Appendix F for diagnostic messages, their causes, and corrective 
action. 
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3.3. GENERATING INPUT EDIT TABLES 


The edit table utility program, ZH#EDT, offers a convenient means for converting 
freeform input received from terminal operators into fixed formats required by your 
action programs and checking this input for types of data, value ranges, and presence 
of required fields. The ZH#EDT utility must be executed after the NAMEREC file has 
been initialized; the edit tables generated are placed in the NAMEREC file. The edit table 
generator is described in the IMS action programming manuals. 


3.4. DATA DEFINITION 


If you are going to use UNIQUE in your IMS application, you must define the files to be 
accessed by your terminal operators by using the data definition processor (DT3DF). 
Your action programs can also access these defined files. The data definition records 
produced by the data definition processor are written to the NAMEREC file. Data 
definition is discussed in the IMS data definition and UNIQUE user guide, UP-9209 
(current version). 
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4. Configuring IMS 


4.1. OVERVIEW OF THE CONFIGURATION PROCESS 


One unified configuration process serves for both single-thread and multithread 
operations in IMS under OS/3. A simple, flexible IMS-supplied job control procedure 
(jproc), IMSCONF, generates and executes an IMS configurator program for either 
single-thread or multithread IMS, produces and links the ultimate load module for the 
online IMS system configured, and stores it in the designated load library. The 
characteristics of the configured IMS system are determined by the parameters you 
supply in the configuration input sections. 


The IMSCONF jproc consists of five job steps necessary to generate an online IMS 
system: 


m CCA Linkage Step 
Links the user communications control area (CCA) and stores the output in a load 
library; the generated load module is loaded in the configuration step in order to 
validate network-related configuration input. 

a =Initialization Step 
Allocates and initializes (or scratches and reinitializes) any or all IMS internal files 
(AUDFILE, AUDCONF, CONDATA, NAMEREC and STATFIL). This step calls the 
procedure IMS#INT, which contains two subordinate jprocs: IMS#NTZ for file 
initialization; IMS#SCR for scratching files. 


= Configuration Step 


Executes the configurator program and generates records in the NAMEREC file. 
Performs the following functions: 


- generates an assembler source module containing all configured user and IMS 
file specifications and other online requirements of IMS; 


- generates a linker source module containing the link stream for the configured 
IMS online module; 


- generates tables and records supporting online IMS; and 
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-  preformats AUDFILE and CONDATA files, as required for a multithread IMS 
configuration; or 


-  preformats an AUDCONF file for a single-thread IMS configuration. 
= Assembly Step 


Assembles the configurator-generated IMS source module and DTFs or CDIB/RIBs 
for your data files. 


w Online Module Linkage Step 


Links IMS object modules and the configurator output into an executable IMS load 
module and places it in a load library. 


The IMSCONF jproc does not always generate all five control streams. You select the 
control streams to be run by means of the CNFJCS and INIT keyword parameters. (See 
4.2.6 and 4.2.9.) In addition, if a fatal error should occur during the configurator 
execution step, the job terminates, and the assembly and online module linkage steps 
are not executed. Figure 4-1 portrays the 5-step configuration process performed by 
IMSCONF. 


Control Stream 
Functions Generated by the 
Performed IMSCONF jproc Files Affected Remarks 


You may define user files in 
place of $YSOBJ and $YSLOD. 
The network load module is 
placed in the file containing 
the configurator load modules. 







Links the user communi- 
cations control area (CCA) 
into a load library file 






CCA Linkage Step 


SYSLOD 


= 
we 


Figure 4-1. Functional Flow of IMSCONF Configuration Process (Part 1 of 2) 


Initialization Step 
(IMSHINT) 





AUDCONF 


You may specify any file- 
identifiers for the AUDCONF, 
AUDFILE, CONDATA, 
NAMEREC, and STATFIL files. 
{The AUDCOMF file takes the 
place of the AUDFILE 

and CONDATA files for 
single-thread IMS.) 


Initializes (or scratches 
and reinitializes) IMS 
internal files 





IMS#NTZ IMS#SCR 
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& Control Stream 
Functions Generated by the 
Performed IMSCONF jproc Files Affected Remarks 













The IMS$ASM and IMSSLNK 
source modules may reside in 
SYSSRC or in a user-defined 
file. Input for the configu- 

rator may be in the same source 
file or in the card reader. 


The OS/3 system scratch 
file $SCR1 is used by the 
configurator. 








Executes the configura- 
tor and generates 
records for the 
NAMEREC file 


Configuration x 
a zi 


AUDCONF 





ws 
ee 


@ Assemblies user DTFs a User-defined files may 
or CDIB/RIBs Assembly Step replace $Y$SRC and $YSOBJ. 
and IMS program peg 


Links IMS and DTFs 
or CDIB/RIBs 

into an executable 
IMS system and 
places system in a 
load library file 


The user may define source, 


Online Module Linkage a object, or load library files 
Step Gea 


in lieu of SYS$SRC, $YSOBJ, 
or $YSLOD. 


Figure 4-1. Functional Flow of IMSCONF Configuration Process (Part 2 of 2) 
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4.1.1. Procedure for Configuring IMS 


The way you configure an online IMS system depends on whether you use card input or 
enter your job from a workstation. 


To configure your IMS system using card input: 

1. Prepare configurator input, as described in 4.3. Follow configurator cards with a // 
FIN card. If desired, file the configurator input in the library named on the LIBS 
parameter of the IMSCONF jproc, using the librarian. See the system service 
programs (SSP) user guide, UP-8062 (current version). 

2. Prepare the job control stream: 

a. Set up the IMSCOMF jproc call line (4.2). 


b. Compute storage requirements for the JOB job control statement (4.2.13). 


c. Place the // IMSCONF card behind the // JOB card; follow it with /& and // 
FIN cards. 


d. If desired, file run stream in the system job control stream library file (SY$JCS) 
by keying in the command FI at the console. If configurator input is from cards 
or if ALTER job control statements are required, you must file the job control 
stream in $Y$JCS. 


3. Run configurator job: 


a. If either the job control stream or the configurator input is on cards, place the 
deck in the card reader. 


b. lf there are any ALTER job control statements (4.2.11), follow them with a // 
FIN card and place in a card reader; if configurator input is on cards, the 
ALTER deck precedes the configurator deck. 


c. Key in the command RUN jobname at the console. 


Figure 4—2 illustrates the job decks required for the configurator job. At the least one of 
the job decks must be filed before running the configurator job. 
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CONFIGURATOR 


/! ascon CALL 
LINE AND ITS SECTIONS 


CONTINUATIONS 
INPUT DECK 
FOR IMS 
CONFIGURATOR 


a. Configuration Job Decks with no ALTER Statements 






CONFIGURATOR 
SECTIONS 
cree 
// JOB // ALTER | 


b. Configuration Job Decks when ALTER Job Control Statements Are Used 


Figure 4-2. Configuring IMS Using Card Input 
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To run your IMS configuration job from a workstation (Figure 4-3): 





1. Prepare configurator input (4.3) using the general editor, and file it in the library 
named on the LIBS parameter of the IMSCONF jproc. Refer to the general editor 
user guide/programmer reference, UP-8828 (current version). 

2. Prepare the job control stream: 


a. Select IMSCONF jproc parameters (4.2) and compute storage requirements for 
the JOB statement (4.2.13). 


b. Perform the logon procedure, as described in the workstation user guide, 
UP-8845 (current version). 


c. Use the general editor to build the job control stream and file it in the $Y$JCS 
system library. 


3. Key in the command RV jobname. 















Enter input, 
Build job control 
stream. 


@ Run job. 





$Y$SRC 
or 
User Library 







//JOB 
7/\MSCONF 





Configurator 
Sections 





Figure 4-3. Configuring IMS from a Workstation 
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4.1.2. IMS Internal Files 


A number of the internal files used online by IMS are described briefly in this paragraph 
because they must be considered at several points in the configuration process: both 
when you are building the call line for the IMSCONF jproc and when you are preparing 
input to the configurator. The file names listed are reserved for IMS files and cannot be 
used for user data files. 


NAMEREC 


The named record file is always required. It contains various control tables 
generated by the configurator and records from pre-online processing. The same 
NAMEREC file may contain records from as many as 255 different IMS 
configurations. However, if you have more than one IMS system online at the same 
time, they can't access the same NAMEREC file. The NAMEREC file is in ISAM 
format in a DTF system; in MIRAM format in a CDM system. 


AUDFILE 


The audit file is a system access technique (SAT) file created for online recovery in 
multithread IMS systems. It consists of pre-update before-images of files. These 
images are used to roll back the file when a CANCEL command (UNIQUE) or a 
ZZCNC terminal command is executed. The audit file is also used for writing IMS 
control information at termination time and therefore is required whether or not 
updating is configured. 


CONDATA 


The continuity data file is also a SAT file whose block size is determined by the 
configurator. It contains data that must be passed from one action to another 
within a transaction. The CONDATA file is required in a multithread configuration if 
you use UNIQUE, if any of your action programs use a continuity data area, or if 
you specify TOMFILE=YES. 


TRCFILE 


The trace file is created online for use in offline recovery if the FUPDATE and 
RECOVERY parameters are both specified in the configurator OPTIONS section. 
Before-images, after-images, or both, are recorded in the trace file, depending on 
the RECOVERY parameter specifications. The trace file is a SAT file, but unlike the 
other internal files, it may be on either disk or magnetic tape. In System 80, the 
trace file can also be on diskette. 


AUDCONF 
The audit and continuity data file is the single-thread IMS counterpart to both the 


AUDFILE and CONDATA files used in multithread IMS systems. Like them, the 
AUDCOMF file is a SAT file. It is always required. 
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me STATFIL 


The statistical data file is used to contain statistical data recorded during online 
processing. It is used in both single-thread and multithread IMS. 


= TOMFILE 


The terminal output message file is actually a partition of the single-thread 
AUDCONF file or the multithread CONDATA file. It is created if you include the 
TOMFILE=YES parameter. The TOMFILE records output messages generated at 
rollback points and at transaction termination to aid terminal operators during online 
recovery. 


These output messages may also be recorded in the trace file so as to permit 
offline reconstruction of the TOMEFILE. 


m LDPFILE 


The fast loader file is a system access technique (SAT) file that is required when 
you include the FASTLOAD=YES parameter in the OPTIONS section. Action 
programs are copied from the action program load library, LOAD, the first time they 
are called by a transaction and then are loaded from the LDPFILE. 


Of the foregoing files, only a NAMEREC file and the STATFIL can be used for both 
single-thread and multithread IMS load modules - none of the others can, and you 
should assign them accordingly. For example, the same AUDCONF file may be used for 
several single-thread IMS load modules, but must never be assigned to a multithread 
IMS system. 


If the same AUDCONF or AUDFILE file is to be used for more than one load module, 
the configuration for each load module must have the same value for the AUDITNUM 
parameter in the GENERAL section. In addition, the largest BLKSIZE specified for any file 
in a FILE section must be the same value in each configuration, and the number of 
terminals designated by the TERMS parameter in the NETWORK section must be the 
same. 


4.2. CALLING THE IMSCONF JOB CONTROL PROCEDURE 

The IMSCONF jproc generates and executes the necessary control streams to perform 
system generation functions for a unique single-thread or multithread online IMS system. 
The keyword parameters of the IMSCONF jproc call line determine the manner in which 
the configuration process is to be performed. You may specify: 

m =the volume on which the various files reside and their file identifiers; 


m= = =whether input is in the card reader or in a source library; 


= a multithread or single-thread IMS system; 
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= DTF mode or CDM mode; 

m= = which control streams are to be run; 

m ~~ listing options; 

= =the names of your online load module and your communications control area; 
mw the format and size of the IMS internal files; and 


m= whether temporary changes must be made to any of the IMS configurator load 
modules. 


All of the IMSCONF keyword parameters are optional. They all have default 
specifications, except for the INIT parameter, which must be coded if internal files are 
to be initialized. 


The IMSCONF jproc call line is illustrated in the following format. The keyword 
parameters are shown here in alphabetic order, but they may be coded in any 
convenient order, following the coding conventions described in the job control user 
guide, UP-8065 (current version). The flowchart in Figure 4-4 illustrates a functional 
sequence for selecting the keyword parameters that need to be coded. The same 
sequence is followed in the subsequent paragraphs, which describe each keyword 
parameter and its functions. Coding examples are included. 


// IMSCONF bas) p(s if 
[esl 


[, CNFJCS=¢ 2], (CCA],{CNF], [ASM], [LNK])] 


sme) ea] 


;{stat-file-id 


oo 
7s 


,INIT=/(1),({blksize-namerec))], 
R NO 
Ss 


3 
6 


cyl-audit-file ,{cyl-condata ,(cyl-statfil 
NO NO NO 
S 5 18 


continued 
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pee src-module-name 


cane ] 

* tl (esi 
£2 
ssi sl ae) 


[, LOADM= onl ine-load-module-name] 


,LST=/((A) 
NO 
C£C] [,01f,0][,81) 
co )Dy8) 


Fs (|) 


4.2.1. Assigning Configurator Library Files (LIBS, LIBO, LIBL) 











The LIBS, LIBO, and LIBL keyword parameters control the assignment of files to contain 
the source, object, and load libraries needed by the configurator. 


The source library file receives output streams from the configuration step of the 
IMSCONF jproc; these are later input to the assembly and linkage steps. It must also 
contain the configurator input if such input is not in the card reader. 


The object library file receives output from the assembler and the configurator in the 
assembly step. This file must contain the IMS object modules provided on your OS/3 
release volume; these modules are linked with the configurator output in the linkage 
step. In the linkage step, IMSCONF also includes data management and system modules 
from the $Y$OBU library file on SYSRES. Because these modules must be current, your 


SYSRES volume must be updated to the current OS/3 release level before you configure 
IMS: 


The load library receives output from the IMS linkage step - the online IMS load 


module. Output from the CCA linkage step goes to the file indicated on the ZCNF 
parameter. 


The LIBS and LIBL parameters default to the $Y$SRC and $Y$LOD library files on 
SYSRES. In Series 90, the LIBO parameter defaults to the $Y$OBJ library on OS/3REL. 


For System 80 users, there is no OS/3REL volume and the LIBO parameter defaults to 
SYSRES. 
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START 


IS USER 

SOURCE LIBRARY 

REQUIRED 
? 



















SPECIFY DEVICE, 
VOLUME, AND 

LIBRARY NAME 
(LIBS) 





DEFAULT: 
SYSSRC ON 
SYSRES 











SPECIFY DEVICE, 
VOLUME, AND 
LIBRARY NAME 
(LIBO) 








IS USER 
OBJECT LIBRARY 
REQUIRED 
? 







DEFAULT: 
SYSOBJ ON 
OS/3REL 






















IS USER SPECIFY DEVICE, 
LOAD LIBRARY VOLUME, AND 
LIBRARY NAME 


REQUIRED 
? (LIBL) 

DEFAULT: 

SYSLOD ON 


SYSRES 


1S 
CONFIGURATOR 
INPUT IN 
SOURCE LIBRARY 
? 












DEFINE SOURCE 
MODULE NAME 
(INPUT) 






DEFAULT: 
INPUT IS 
ON CARDS 







ARE 
LISTING OPTIONS 


DESIRED 
? 


SPECIFY 
ila LISTING 
OPTIONS 

(LST) 





DEFAULT: 
LST=C,D,S 
YES SPECIFY 
CDM=YES 
DEFAULT: 
DTF 
MODE 


Figure 4-4. Flowchart for Selecting IMSCONF Jproc Parameters (Part 1 of 3) 
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IS THIS A SPECIFY 





MULTITHREAD TYPE OF 
CONFIGURATION CONFIGURATION 
? (ZCNF) 









DEFAULT: 
SINGLE-THREAD 





SPECIFY 
LOCATION OF 
CONFIGURATOR 
MODULES 
(ZCNF) 







DEFAULT: 
OS/3REL 
























ARE ANY SPECIFY JOB 
CONTROL STREAMS CONTROL STREAMS 
TO BE OMITTED TO BE RUN 
DEFAULT: (CNFJCS)* 
RUN ALL 
CONTROL 
STREAMS* 





IS 
USER-DEFINED 
CCA NAME 
REQUIRED 
? 


SPECIFY 
CCA NAME 
(CCA) 


YES 











DEFAULT: 
IMS4 


























IS CCA SPECIFY 
OBJECT MODULE LOCATION OF 
ON SYSRES OR CCA OBJECT 

USER VOLUME MODULE 





DEFAULT: 


(CCA) 
OS/3REL 





*Does not apply to IMS#INT control stream, which is governed by the INIT keyword parameter. 


Figure 4-4. Flowchart for Selecting IMSCONF Jproc Parameters (Part 2 of 3) 
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SPECIFY VOLUME(S) 
AND NAMES FOR 
NAMED RECORD, 
YES AUDIT, CONTINUITY 
DATA, AND 
STATISTICAL DATA se 
FILES (IMSFIL) 








USER NAMES 
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DESIRED FOR 
INTERNAL 
FILES 
DEFAULT: ? 
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AUDFILE, CONDATA 
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? 





DEFAULT: 
NO INITIALIZATION DEFAULTS: 
NO 3072.75 
} 6144 { 


SPECIFY NUMBER 
OF CYLINDERS 
FOR AUDCONF OR 
AUDFILE AND 
CONDATA, OR 
NO INITIALIZATION 


















IS 
USER-NAME 
















SPECIFY NAME 


DEFAULTS: 
DESIRED FOR FOR ONLINE 15 
ONLINE LOAD LOAD MODULE | 10,5 
MODULE (LOADM) 


DEFAULT: 
ZQ#IMS 
ZS#IMS 
ZQSIMS 
ZSSIMS 


? 


SPECIFY NUMBER 


OF CYLINDERS 
FOR STATFIL 











ARE ANY 
ALTER JOB CONTROL 
STATEMENTS 

REQUIRED 





SPECIFY 
ALTER=YES 





DEFAULT: ? ; 
NO ALTER oon 
STATEMENTS 


Figure 4-4. Flowchart for Selecting IMSCONF Jproc Parameters (Part 3 of 3) 
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The purpose for the OS/3REL default in Series 90 is to save file space on the SYSRES 
volume; once the configuration process is completed, the object modules produced are 
no longer needed, and it would serve no useful purpose to keep them online. For the 
same reason, you have the option at SYSGEN of excluding the IMS object modules and 
the configurator load modules from the SYSRES volume being created. If you do so, 
you must have the OS/3REL volume online at configuration and specify (or default) 
OS3REL for LIBO and for the ZCNF keyword parameter. As an alternative to both 
SYSRES and OS/3REL, you may copy these modules to a user volume. 


NOTE: 


OS/3 defines SYSRES as the volume from which the initial program load (IPL) of the 
supervisor has been made. If you configure IMS immediately after a SYSGEN in which 
you are creating a new SYSRES and the IPL was made from OS/3REL, that volume is 
defined as SYSRES and you must identify the new SYSRES volume by a logical unit 
number and volume serial number. If the IPL for the SYSGEN procedure was from a 
previous SYSRES, you must re-IPL from the new SYSRES to ensure that current system 
and data management modules are included in your configuration. 


LIBS Keyword Parameter: 


hy) 


Generates a device assignment set for the configurator source library file. 





Subparameter 1: 


tun 
Is any acceptable logical unit number ranging from 51 to 89, indicating a disk 
unit containing a volume other than SYSRES or OS/3REL. 


50 


Specifies the device containing the OS/3REL volume. 





Specifies the device containing the SYSRES volume and is the default value. 
Subparameter 2: 


vsn 
Specifies the volume serial number of the volume containing the source library 


file. 
OSSREL 
Specifies that the source library file is on OS/3REL (Series 90 only). IMSCONF 
generates a volume serial number of RELnnn when OS3REL is specified, where & 








nnn represents the release level. 


UP-8364 Rev. 7 SPERRY UNIVAC OS/3 4-15 
IMS SYSTEM SUPPORT FUNCTIONS 








| ‘Indicates that the source library file resides on SYSRES and is the default 
assumption. 


Subparameter 3: 


src-lib-name 


Defines a source library file other than $Y$SRC. 





Specifies that configurator source modules are to be filed in $Y$SRC on either 
SYSRES or OS/3REL and is the default assumption. 


LIBO Keyword Parameter: 


Generates a device assignment set for the configurator object library file. 





Subparameter 1: 


tun 
Is a logical unit number, ranging from 51 to 89, indicating a disk unit 
containing a volume other than SYSRES or OS/3REL. Use the same logical unit 
number specified for the source library file if both are on the same volume. 





Specifies the device containing the OS/3REL volume. 


RES 
Specifies the device containing the SYSRES volume. 


Subparameter 2: 
vsn 


Specifies the volume serial number of the volume containing the object library 
file. 





Indicates that the object library file is on OS/3REL and is the default 
assumption in Series 90. IMSCONF generates a volume serial number of 
RELnnn, where nnn represents the release level. 


SYSRES 
Specifies that the object library file is on SYSRES and is the default in System 
80. 
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Subparameter 3: 


obj -lib-name 
Defines an object library file other than $Y$OBJ. If you specify a user library, 
you must copy the IMS object modules provided on your OS/3 release volume 
into this library. 





Specifies that configurator object modules are in $Y$OBJ on either SYSRES or 
OS/3REL and is the default assumption. 


LIBL Keyword Parameter: 


“HE 


Generates a device assignment set for the configurator load library file. This 
file will contain the online IMS load module. 


* 








Subparameter 1: 


lun 
Is a logical unit number, ranging from 51 to 89, indicating a disk unit 
containing a volume other than SYSRES or OS/3REL. Use the same logical unit 
number specified for the source and/or object library file if they are on the 
same volume. 


50 


Specifies the device containing the OS/3REL volume. 





; Specifies the device containing the SYSRES volume. 
Subparameter 2: 


vsn 
Specifies the volume serial number of the volume containing the load library 
file. 


OS3REL 
Specifies that the load library file is on OS/3REL (Series 90 only). IMSCONF 
generates a volume serial number of RELnnn, where nnn represents the release 
level. 





Indicates that the load library file is on SYSRES and is the default assumption. 
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Subparameter 3: 


load-lib-name 
Defines the load library file other than $Y$LOD which is to contain the online 
IMS load module produced by the configuration process. 





Indicates that the online IMS load module is to be filed in $Y$LOD on either 
SYSRES or OS/3REL and is the default assumption. 


4.2.2. Defining Configurator Input (INPUT) 

The input to the configurator program may be in the card reader or may be stored on 
disk. If the configurator input is on disk, you must specify the name of the source 
module by means of the INPUT keyword parameter. The module must be in the source 
library file defined by the LIBS keyword parameter. 

INPUT Keyword Parameter: 


as iat 





where: 


src-module-name 
Defines the source module that the configurator accesses for its input. The 


module must be in the source library file defined by the LIBS keyword 
parameter. 





Indicates that configurator input is in the card reader and is the default 
assumption. 


4.2.3. Selecting Listing Options (LST) 


You may use the optional LST keyword parameter to specify your choice of the various 
listing options available from the configuration process - but you may also use it to 
bypass configuration altogether and simply list the directory of the NAMEREC file to 
review its current state. Otherwise, the NAMEREC directory is routinely printed at the - 
end of each configurator run, regardless of what listing options are selected. 


The NAMEREC directory lists, for each configured IMS load module having records in 
the file, the identification of the configuration, the name of the ICAM network definition, 
the date of configuration, the time of the configurator run, the version number of the 
IMS configurator used, and an indication of the number of errors present in the file. 
Entries are printed in ascending order of configuration identifiers. Figure 4-5 provides an 
example of the NAMEREC file directory. 
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NAMEREC DIRECTORY 
CNF-1D(1) CNF-NETW(2) CNF-DATE(3) CNF-TIME(4) CNF-VERS(5) CNF -ERRORS(6) 


0001 IMS5 81/12/18 04:34:08 VER8.0.08-MT 0049 
0009 IMS5 81/11/07 12:98:02 VER8.0.07-MT 0039 
0022 IMS1 80/02/07 01:37:23 VER7.0.07-ST 0001 
0105 IMS5 81/12/18 03:35:03 VER8.@.08-ST 0011 
0111 IMS6 81/09/03 07:27:26 VER8.@.06-MT 0004 








NOTES: 


1 Configurator identifier - Decimal integers in the range 0001 ~ 0255 that uniquely identify an IMS load module. 
Specified to the configurator in the NETWORK section via the CONFID keyword parameter. 


2 Configured network - A 4-character alphanumeric identification of the ICAM network definition, specified to the 
configurator in the NETWORK section via the NAME keyword parameter. 


3 Configuration date - Date of the configuration run. 
4 Configuration time - Time of the configurator run. Uses the 24-hour time-keeping system. 
5 Configurator version - The version number of the IMS configurator used. 


6 Configuration errors - The number of errors logged by the configurator during the run represented by this line; not 
necessarily the number of errors in the NAMEREC file records generated for the IMS load module identified in the 
first column. 


Figure 4-5. Example of NAMEREC File Directory Listed by the IMS Configurator 


To cause the directory to be listed alone, without going through configuration, you 
specify LST=(A) to the IMSCONF jproc, and you do not provide any input to the 
configurator. See 4.2.14 for a coding example. 


Another listing option of the IMSCONF jproc, LST=(D), causes the listing of all 
generated data and prints the contents of each table generated by the configurator for 
the NAMEREC file. This output may be useful in debugging the configuration process, 
but it does not list the entire contents of the NAMEREC file. The records inserted in the 
NAMEREC file by the edit table generator or the data definition processor, and the 
password definition records filed by the ZP#NRU utility, for example, are not listed by 
this LST option, nor are they represented in the NAMEREC file directory. You can obtain 
a listing of all the records in the NAMEREC file only by means of the NAMEREC file 
utility (ZP#NRU), as described in 3.2.2. 


The four keyletters C, D, O, and S are nonpositional, optional subparameters. They may 
be specified in any order, separated by commas. All listing options except NO must be 
enclosed within parentheses. 
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® LST Keyword Parameter: 


LST=(CA) 
C(C}{,D1[,01{,8})) 





NO 


where: 


Lists the directory of the NAMEREC file and bypasses the configuration 
process. No other IMSCONF keyword parameter except ALTER=YES may be 
specified, nor is any input provided for the configurator. 


When the NAMEREC file contains no configurator-generated records, the 
following message is listed in place of the directory: 


NO CONFIGURATIONS PRESENT IN THIS NAMEREC FILE 


C 
Lists all configurator options, plus defaults. 

D 

@ Lists generated data and prints the contents of each table generated by the 

configurator for the NAMEREC file (useful as a configurator debugging aid). 

0 
Lists all configurator output generated to the source library. 

S 
Lists all input parameter cards read by the configurator. 

NO 


Suppresses the configuration listing. The configurator nevertheless prints the 
following: 


m the NAMEREC directory; 


m the NETWORK section, including all its keyword parameters input to the 
configurator; 


wall configurator errors (Table F-2); and 
m the error cross-reference listing. 


If the LST keyword parameter is omitted, IMSCONF assumes LST=(C,D;S). 
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4.2.4. Choosing DTF or CDM Mode (CDM) 


With the CDM parameter, you tell IMSCONF whether to generate an IMS system in DTF 
mode or CDM mode. In DTF mode, IMS supports DAM, ISAM, MIRAM, and SAM disk 
files and SAM tape files. In CDM mode, IMS supports MIRAM disk files and CDM 
sequential tape files. Refer to 1.4 for more information about DTF and CDM modes. 


CDM Keyword Parameter: 





Designates DTF mode and is the default assumption. 
YES 
Designates CDM mode. 
4.2.5. Configuring a Single-thread or Multithread System (ZCNF) 
The ZCNF keyword parameter determines whether this is a single-thread or multithread 
IMS system and identifies the library containing the configurator load modules. 


Single-thread and multithread IMS systems are discussed in 1.1.2. 


ZCNF Keyword Parameter: 


Subparameter 1: 






MT 


Configures a multithread IMS system. 





Configures a single-thread IMS system. 


Subparameter 2: 





Indicates that the configurator load modules reside in $Y$LOD on OS/3REL 
(Series 90 only). The configurator generates a logical unit number of 50 for 
this volume. Do not use a logical unit number of 50 in the LIBS, LIBO, or LIBL 
specifications unless those libraries reside on OS/3REL.) 
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Indicates that the configurator load modules reside in $Y$LOD on your system 
resident (SYSRES) volume. This is the default in System 80. 


USR 
Indicates that the configurator load modules reside in a user library file. If USR 
is specified, the configurator load modules must be in the file specified by the 
LIBL keyword parameter. 


4.2.6. Selecting the Control Streams to Be Generated (CNFJCS) 


There may be occasions when you do not require all of the five control streams to be 
generated by the configuration process; for example, if you have already established a 
network load module and internal files for another configuration. The CNFJCS and INIT 
keyword parameters determine which control streams IMSCONF will generated. The 
CNFJCS parameter, described here, governs the generation of four of the IMSCONF job 
steps through the specification of positional subparameters. If CNFJCS is omitted, the 
four steps are all generated. The INIT parameter (4.2.9) controls the initialization run 
stream, which initializes (or scratches and reinitializes) the IMS internal files. 


CNFJCS Keyword Parameter: 


CNFJCS=([ 





J], [CCA], [CNF], [ASM], [LNK]) 


where: 





Generates the entire run stream within the IMSCONF jproc (except for file 
initialization). 


Generates the run stream to link the user communications control area (CCA). 


CNF 


Generates the run stream to execute the configurator. 


ASM 
Generates the run stream to assemble the output of the configurator. 


Generates the run stream to link the online IMS. 
Consider the following examples of coding the CNJFCS keyword parameter: 


CNFJCS=CALL) 
CNFJCS=(,CCA,CNF) 
CNFJCS=(,,CNF) 
CNFJCS=(,,CNF,ASM,LNK) 
CNFJCS=(,,,ASM,LNK) 


OOOVO 
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@) Generates the entire IMSCONF jproc run stream except for file initialization 
(specified by the INIT parameter). Omitting the CNFJCS keyword parameter has 
the same effect. If a fatal error occurs during the configurator execution step, 
the job is terminated and the assembly and online module linkage steps are 
not performed. 


Generates the run streams to link the CCA and execute the configurator. 


Generates only the run stream for executing the configurator. 


©® © © 


Generates the run streams for executing the configurator and for assembling 
and linking its generated output. If a fatal error is encountered during the 
configurator execution step, the assembly and linkage steps are not performed. 


® Generates the run stream for assembling and linking the output from the 
configurator. This specification should not be made if the INIT keyword 
parameter is used. 


A recommended approach to initial configuration of IMS, using the CNFJCS and INIT 
keyword parameters, is as follows: 


1. Run the CCA linkage, file initialization, and configurator execution steps (Example 2 
and the INIT parameter). 


2. Check the configurator output for errors, and rerun the configurator step (Example 
3) until the configurator output is acceptable. 


3. Run the configurator, assembly, and online module linkage steps (Example 4), or 
omit the configurator step (Example 5) if the previous run was error free. 


Any reconfiguration you perform with the intent to produce a new IMS load module 
must at least include the configuration, assembly, and linkage steps of the overall 
configuration process. If you intend to use the same NAMEREC file established for one 
or more previously configured load modules, we recommend that you run only the 
configurator step, using a temporary NAMEREC file, until the output is acceptable; then 
execute the configurator, assembly, and linkage steps using the established NAMEREC 
file. This will minimize the chance of compromising an already established NAMEREC 
file. 


4.2.7. Identifying the Communications Control Area (CCA) 


The CCA keyword parameter identifies the communications control area (CCA) object 
module to be linked in the CCA linkage step of the configuration process. The CCA 
object module is created in the system generation procedure that produces the ICAM 
symbiont for use by your online IMS system. You must specify SAVE=YES on the CCA 
macro to save the object module. The CCA module resides in the $Y$OB4J library file of 
the OS/3 release volume (OS/3REL) in Series 90, or the SYSRES volume in System 80, 
unless you copy it to another volume. The load module created by the CCA linkage 
step is stored in the file containing the configurator load modules, as indicated by the 
ZCNF keyword parameter. 
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CCA Keyword Parameter: 


“(Uf 


Subparameter 1: 





cca-name 
Specifies the name of the CCA object module to be linked by the CCA linkage 
step. This name must match the label of the CCA macro in the ICAM 
generation and the specification of the NAME keyword parameter in the 
NETWORK section of configurator input. The default value is IMS4. 


Subparameter 2: 


REL 
Indicates that the CCA object module generated by the SYSGEN procedure 
resides in $Y$OBJ on OS/3REL (Series 90 only). The configurator generates a 
logical unit number of 50 for this volume. (Do not use a logical unit number of 
50 in the LIBS, LIBO, or LIBL specification unless those libraries reside on 
OS/3REL.) 


RES 
Indicates that the CCA object module resides in $Y$OBJ on your system 
resident (SYSRES) volume. This is the default in System 80. 


USR 
Indicates that the CCA object module is in a user library file. If USR is 
specified, the CCA object module must be in the file specified by the LIBO 
keyword parameter. 


NOTE: 


If the initial program load (IPL) has been performed from OS/3REL, that volume must be 
defined as RES. 


4.2.8. Assigning IMS Internal Files (IMSFIL[n]) 


The IMSFIL[n] keyword parameter controls the assignment of the IMS internal files 
required by this configuration. A named record file (NAMEREC) is always required. 
Additionally, a multithread configuration requires an audit file (AUDFILE) and generally 
requires a continuity data file (CONDATA); a single-thread configuration requires an audit 
and continuity data file (AUDCONF), which is the counterpart to both the AUDFILE and 
the CONDATA files. A STATFIL is always required. 
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lf all of the internal files are to reside on the same disk volume, you may use the IMSFIL 
format, without a subnumber (n). If these files are to reside on separate volumes, you 
code the keyword parameter IMSFIL1 for the named record file, IMSFIL2 for the audit 
file or audit and continuity data file, IMSFIL3 for the continuity data file, and IMSFIL4 for 
the STATFIL. In this case, subparameters 4, 5, and 6 are omitted, and the file identifier 
in each case is coded as subparameter 3. Examples are given following the parameter 
descriptions. 


You may choose your own file identifiers for the IMS internal files. However, regardless 
of the file identifiers used, you must specify the names NAMEREC, AUDFILE, 

~< CONDATA, AUDCONF, and STATFIL on the LFD job control statements at IMS start-up 
time. 


IMSFIL[n] Keyword Parameter: 


fame] ee 
a ONE CONDATA 


where: 





a 









Indicates which of the IMS internal files is to be assigned: 


\ 


1 named record file 


2 


audit file (multithread) or audit and continuity data file (single-thread) 


3 = continuity data file (multithread) 


4 = statistical data file 
If n is omitted, all the IMS internal files are to reside on the same volume. 
Subparameter 1: 


Lun 
Is a logical unit number, ranging from 51 to 89, indicating a disk unit 
containing a volume other than SYSRES. Use the same logical unit number 
specified for LIBL if the internal files are to reside on the same volume with the 
online IMS load module. For diskette volumes, logical unit numbers range from 
130 to 133 and 136 to 159. Refer to the job control user guide, UP-8065 
(current version) for appropriate logical unit numbers. 





Specifies the device containing the SYSRES volume and is the default value. 








UP-8364 Rev. 7 SPERRY UNIVAC OS/3 4-25 
IMS SYSTEM SUPPORT FUNCTIONS 








Subparameter 2: 


vsn 


Specifies the volume serial number of the disk volume containing the file or 
files referenced by this keyword parameter. 





Specifies that the file or files referenced by this parameter are to reside on 
SYSRES. This is the default assumption. 


Subparameter 3: 


named-rec-file-id 


Specifies a file identifier for the named record file. The default is NAMEREC. 
Subparameter 4: 


audit-file-id 
Specifies a file identifier for the audit file in a multithread configuration, or the 
audit and continuity data file in a single-thread configuration. The default for 
multithread is AUDFILE; for single-thread, AUDCONF. If the keyword parameter 
IMSFIL2 is used, the audit file identifier is specified for subparameter 3. 


Subparameter 5: 


cont-data-file-id 
Specifies a file identifier for the continuity data file in a multithread 
configuration. The default is CONDATA. If the keyword parameter IMSFIL3 is 
used, the continuity data file identifier is specified for subparameter 3. 


Subparameter 6: 


stat-file-id 
Specifies a file identifier for the statistical data file. The default is STATFIL. If 
the keyword parameter IMSFIL4 is used, the statistical data file identifier is 
specified for subparameter 3. 


Following are several coding examples for the IMSFIiL[n] keyword parameter: 


IMSFIL=(,, IMSREC,AUDIT1) 

IMSFIL=(51,DISKO1) 

IMSFIL1=(51,DISKO1, IMSREC), IMSFIL2=(52,DISK02,AUDIT1), X 
IMSFIL3=(52,D01SK@2,CONREC1) 

IMSFIL4=(51,DISK61,MYSTAT) 


Specifies the file identifiers IMSREC for the named record file and AUDIT1 for 
the audit file, if this is a multithread configuration, or the audit and continuity 
data file, if single-thread. If this is a multithread configuration, the name 
CONDATA will be assigned to the continuity data file and STATFIL to the 
statistical data file by default. In this example, all the internal files are to reside 
on SYSRES. Note that commas must be coded in place of the missing 
subparameters. 


@ © 6606 
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@) Specifies that all IMS internal files are to reside on disk volume DISKO1; the 
disk unit is assigned the logical unit number 51. The files are to be labeled 
NAMEREC, AUDFILE, CONDATA, and STATFIL if this is a multithread 
configuration, or NAMEREC, AUDCOMF, and STATFIL, if single-thread. 


8) Specifies that the named record file, IMSREC, is assigned to volume DISKO1, 
on disk unit 51, and the audit and continuity data files, AUDIT1 and CONREC1, 
are assigned to volume DISKO2, on disk unit 52. Note that the file identifier is 
coded as subparameter 3 in each case. 


@) Specifies that a statistical data file, MYSTAT, is to reside on disk volume 
DISKO1; the disk unit is assigned to logical unit number 51. 


NOTE: 


Embedded blanks are permitted in the file identifiers for the named record, audit, 
continuity data, and statistical data files and for the configurator library files. Do not use 
quotation marks in the IMSFIL[n], LIBS, LIBO, or LIBL parameter specifications. When 
you use embedded blanks, IMS generates an LBL job control statement in the form 
// LBL ‘file-identifier’. For example, the specification 


IMSFIL2=(55,DISK@3,AUDIT FILE) 


generates the job control statement // LBL ‘AUDIT FILE’, and the specification 


LIBS=(60,DISK@1,IMS SOURCE) 


generates the job control statement // LBL ‘IMS SOURCE’. 


4.2.9. Initializing IMS Internal Files (INIT) 


The INIT keyword parameter generates the control stream for the initialization step, 
which allocates and initializes the IMS internal files. This parameter can be used to 
selectively initialize, or scratch and reinitialize, the NAMEREC, AUDFILE, CONDATA, 
AUDCOMF, and STATEFIL files. 


If you omit the INIT parameter, no file initialization is performed; IMS assumes that all 
files have previously been allocated and initialized. If only the NAMEREC file has 
previously been initialized, include INIT but specify NO for the second subparameter. If 
you reinitialize the NAMEREC file at this time (regardless of whether you specify |, R, or 
S), all its contents will be destroyed, including any generated data definitions, password 
definitions, edit tables, and configuration records from other IMS load modules. 


The INIT parameter is also used to specify the blocksize and number of blocks for the 
NAMEREC file and the number of cylinders for the audit, continuity, and statistical data 
files. 
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| 


| 
& Default values are assumed if you specify INIT but omit any of its subparameters; you 
must specify NO for each file you don't want initialized. A comma must be coded in 
place of any omitted subparameters, except for trailing subparameters. 


INIT Keyword Parameter: 


blocks-namerec \ cyl-audit-file 
sas a0 





INIT= fh blksize-namerec {i 
R} |} ae 


,(cyl-condata ;(cyl-statfil 
fs ff 


Subparameter 1: 








I 
Initializes and allocates file space for the files indicated in subparameters 2 
through 6. 


Reformats a previously allocated NAMEREC file. Other internal files are 
assumed to have been previously allocated and initialized. When this option is 

& specified, the total size of the NAMEREC file cannot be changed. If blocksize is 
altered, the number of blocks must be changed in inverse proportion. Both 
blocksize and number of blocks must be specified, or both omitted. If both are 
omitted, the previously established specifications remain in effect. 


Deallocates (scratches), reallocates, and reinitializes the indicated files. 
Subparameter 2: 


blksize-namerec 
Specifies the number of bytes in a block of the NAMEREC file. This value may 
range from 1024 to 12,800, but it must be a multiple of 256 and must not 
exceed the track size of the disk or diskette subsystem on which the file 
resides. If omitted, IMSCONF applies a default blocksize of 3072 for a 
single-thread configuration, 6144 for multithread; if R is specified for 
subparameter 1, the previously established blocksize remains in effect. 


NO 
Specifies that a NAMEREC file is not to be allocated or initialized. The 
configurator assumes that a previously initialized NAMEREC file is available and 
can be assigned for the configuration step. 


Y 


UP-8364 Rev. 7 SPERRY UNIVAC OS/3 4-28 


IMS SYSTEM SUPPORT FUNCTIONS 





Subparameter 3: 


blocks-namerec 


Specifies the number of blocks that IMSCONF is to allocate when initializing the 
NAMEREC file. The default value is 75 for both single-thread and multithread 
IMS; if R is specified for subparameter 1, the previously established number of 
blocks remains in effect. 


The default value of 75 blocks is suitable for an average size configuration, 
i.e., approximately 20 terminals, 30 files, 30 actions, 30 programs, 15 
transactions. Larger configurations require more blocks, usually 100 or 150. 
Also, if the NAMEREC file holds more than one configuration (see the CONFID 
parameter, 4.3.1.2), the number of blocks specified should be a multiple of the 
number of configurations. For more information on specifying the number of 
blocks in the NAMEREC file when multiple configurations are used, see C.2.2. 


Subparameter 4: 


cyl-audit-file- 


NO 


Specifies the number of cylinders to be allocated for the AUDCONF file in a 
single-thread configuration or the AUDFILE file in multithread. The default value 
for an AUDCONMF file is 15 cylinders; the default for an AUDFILE file is 10 
cylinders. You must generate an audit file whether or not this IMS system 
includes file updating. If file updating is not configured, you can allocate as 
little as 1 cylinder for this file. 


Specifies that an AUDCONF or AUDFILE file is not to be allocated or intialized. 
The configuration assumes that this file is available and assignable for the 
configuration step. 


Subparameter 5: 


cyl-condata 


NO 


Specifies the number of cylinders to be allocated for the CONDATA file in a 
multithread configuration. The default value supplied by IMSCONF is 5 
cylinders. This subparameter is not applicable to single-thread IMS. 


Specifies that a CONDATA file is not to be allocated or initialized. The 
configurator assumes that this file is available and assignable for the 
configuration step or that this configuration is not to include a CONDATA file. 


Subparameter 6: 


cyl-statfil 


NO 


Specifies the number of cylinders to be allocated for the STATFIL. The default 
assumed by IMSCONF is 10 cylinders. 


Specifies that a STATFIL file is not to be allocated or initialized. 
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NOTE: 


You may initialize the NAMEREC file by executing the NAMEREC file utility (ZP#NRU). 
However, the AUDCONF, AUDFILE, CONDATA, and STATFIL files can be preformatted 
for online IMS use only by running the IMSCONF job control stream. 


Initializing (or reformatting) the NAMEREC file results in a new file, and after a successful 
configuration, only the new _ configuration records exist in the file. All previous 
nonconfiguration records (data definitions, password definitions, edit tables), as well as 
configuration records from any other IMS load modules, must be regenerated into this 
new NAMEREC file. 


The following coding examples illustrate the uses of the INIT keyword parameter. Note 
that commas are coded in place of missing subparameters. 


INIT=(1) 
INIT=(1, 4696, 190,20) 
INIT=(S,NO,,,NO) 
INIT=(R, 1024, 150) 
INIT=(1,,100,20,NO) 
INIT=(1,NO) 


OOOQOLO 


@) Initializes all the IMS internal files. If this is a single-thread configuration, default 
values of 75 blocks and blocksize of 3072 will be applied for the NAMEREC 
file, and 15 cylinders for the AUDCONF file. If it is multithread, NAMEREC 
blocksize will be 6144, 10 cylinders will be allocated for the AUDFILE file, and 
5 cylinders for the CONDATA file. 


Indicates that all files are to be initialized and specifies values for the 
NAMEREC and AUDCONF or AUDFILE files. If this is a multithread 
configuration, the CONDATA file will be assigned 5 cylinders. 


© 


Scratches and reinitializes only the AUDFILE in a multithread configuration, 
using the default value of 10 cylinders. 


Reformats the existing NAMEREC file with 150 blocks and a blocksize of 
1024. 


Initializes the NAMEREC and AUDFILE files in a multithread configuration. The 
default value of 6144 is applied for the NAMEREC blocksize. 


© © ®& 


© Initializes all internal files except NAMEREC. 


4.2.10. Naming the Online IMS Load Module (LOADM) 


The LOADM keyword parameter assigns a name to the online IMS load module being 
configured. The load module is generated into the load library file indicated by the LIBL 
keyword parameter; if LIBL is omitted, it is stored in $Y$LOD on SYSRES. 
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LOADM Keyword Parameter: 


LOADM=onl ine-module-name 
Assigns a name to the online IMS load module. The default name is: 


# ZQ#IMS for a multithread DTF configuration; 
ws ZS#IMS for a single-thread DTF configuration; 
= ZQ$IMS for a multithread CDM configuration; or 


w ZSS$IMS for a single-thread CDM configuration. 


4.2.11. Reading ALTER Job Control Statements (ALTER) 


The ALTER job control statement, used to make minor changes in a load module at 
execution time, is described in detail in the OS/3 job control user guide, UP-8075 
(current version). If a problem arises with one of the IMS configurator load modules, and 
you receive a patch to be applied to it via one or more ALTER statements from your 
Sperry Univac system analyst, you must use the ALTER keyword parameter to prevent 
the ALTER job control statements from being processed as input for the configurator. If 
your system does not include a card reader, this parameter does not apply. 


The cards containing the Sperry Univac-supplied ALTER statements must be in the card 
reader and (if card input for the configurator is specified) in front of the configurator 
input cards. You need a FIN job control statement to separate the ALTER cards from 
the configurator input cards, which must also be followed by a FIN statement so that 
the CR job control statements embedded within the jproc may terminate the reading of 
cards for each set of data required in the generated run stream. (See 4.1.1 and Figure 
4-3.) 


ALTER Keyword Parameter: 


Specifies whether ALTER job control statements are present in the card reader for 
making temporary changes to configurator load modules. 


aL Ten =| 


where: 





Specifies that no ALTER job control statements are inserted in the card reader 
and is the default assumption. 


YES 
Specifies that ALTER job control statements are inserted in the card reader (as 
just described) and causes them to be read as such by the IMSCONMF jproc. 
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if ALTER job control statements are present in the card reader but the ALTER 
keyword parameter is omitted (or ALTER=NO is specified), they are not applied 
but rejected as invalid configurator input. 


4.2.12. Identifying Precataloged, Password-Protected Files 


When using previously cataloged files with read/write password protection, you must 
identify any of the IMSCONF files according to the LBL format described in the job 
control user guide, UP-8065 (current version). In this case, cataloged and 
password-protected files should be specified as user files by specifying USR as the 
second positional parameter on the CCA and ZCNF parameters of the IMSCONF jproc. 
You must also follow this procedure for identifying system files on SYSRES or 
OS/3REL. (See the IMSCONF jproc format in 4.2.) For example: 


LIBO=(RES, , SYSOBJ (rpw/wpw) ) 
LIBL=(5@,O0S3REL,$YS$LOD(rpw/wpw) 
IMSFIL=C(RES, ,NAMEREC(rpw/wpw) , AUDCONF ) 


where: 


(rpw/wpw) 
Is read password/write password. 


4.2.13. Main Storage Requirements 


Before running the configurator job (or filing the control stream that contains your 
IMSCONF jproc call in $Y$JCS), you need to estimate the minimum main storage 
required for the configuration process so that it may be specified on the JOB job control 
statement. You are concerned here with the min parameter of the JOB statement. The 
IMS configurator is not structured so as to take advantage of additional main storage; 
to assign more via the max parameter would serve no useful purpose. 


Your requirements depend upon the size of the configurator load module you are using, 
the size of the CCA object module to be linked, and the block size you have determined 
for the NAMEREC file. Use the following formula in estimating the minimum main 
storage required and round the result upward to the next higher multiple of 256 bytes 
before specifying your final result in hexadecimal via the min parameter on the JOB 
control statement for the IMSCONF job: 


R = (configurator-size) + (CCA-size) + (2*(NAMEREC -blocksize) )+3072 


where: 


R 
ls the intermediate result, in decimal, to be rounded upward to the next 
256-byte boundary. 
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configurator-size 
Is the length, in bytes, of the configurator load module to be used. The size of 
the single-thread configurator module, ZS#CNF, is 92D0,, bytes, or 
approximately 37.5K decimal bytes; the size of the multithread configurator 
module, ZO#CNF, is 92D0,, bytes, or approximately 37.5K decimal bytes. 


CCA-size 
Is the length, in bytes, of the CCA object module to be linked in the first step 
of the configuration process. The size of the CCA module is listed in the 
output of the SYSGEN run that produced the ICAM symbiont for use by your 
online IMS system. The name of the CCA module in the SYSGEN output listing 
is CCA$xxxx, where xxxx is the network-name specified as the label on the 
CCA macro. 


NAMEREC-blocksize 
Is the block size of the NAMEREC file. This should be the same figure as 
specified to the IMSCONF jproc via the INIT keyword parameter (4.2.9), or the 
BLKSZE keyword parameter of the NAMEREC file utility program (3.2.1). 


The following example applies this formula to calculating main storage requirements for 
configuring a single-thread IMS load module. 


Given: 
configurator-size = 37,584 bytes 
CCA-size = 8192 bytes (from SYSGEN output listing) 


NAMEREC-blocksize = 3072 bytes (This happens to be the default assumption for 
single-thread.) 


Intermediate results: 
R = 37,584 + 8192 + (2*3072) + 3072 = 54,992 
Round up: 
54,992 + 48 = 55,040 
Specification for min parameter on JOB card (in hexadecimal): 
D700 


The next example uses the same formula to illustrate calculation of main storage 
required for configuring a multithread IMS load module. 
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Given: 
configurator-size = 37,584 bytes 
CCA-size = 16,384 bytes (from SYSGEN output listing) 


NAMEREC-blocksize = 8000 bytes (Assume that the application required a data 
definition record larger than the multithread default value, 6144 bytes.) 


Intermediate results: 


R = 37,584 + 16,384 + (2*8000) + 3072 = 73,040 
Round up: 

73,040 + 176 = 73,216 
Specification for min parameter on JOB card (in hexadecimal): 


11E00 


4.2.14. Sample Control Streams for IMS Configuration 


Control streams containing the IMSCONF jproc call are illustrated in the following coding 
examples: 


Example 1: 


1 10 16 72 


// JOB IMS9O, ,D700 

// IMSCONF INIT=(1),CDM=YES 
/& 

// FIN 


Example 1 illustrates the minimum job control stream for running all five steps of 
the configurator process for a single-thread CDM configuration. The only keyword 
parameters required are INIT, which initializes the IMS internal files, and CDM, 
which tells IMS your system operates in CDM mode. Default values are applied for 
all other parameters and for the optional subparameters of the INIT keyword 
parameter. 


Example 2: 


// JOB IMS,,E000 

// IMSCONF CNFJCS=(,CCA,CNF), IMSFIL=(51,DISK08), INPUT=IMSSRC, X 
// LIBL=(51,DISK08, IMSLOD) , LOADM=IMS9@, CCA=(IMS1) 

/& 

// FIN 





t 


t 
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The control stream in Example 2 indicates the following: 

















m Only the CCA linkage and configuration job steps are to be run. (Once an 
acceptable listing is obtained, the assembly and linkage steps can be added.) 
Internal files are assumed to have been previously allocated and _ initialized, 
perhaps from another configuration. 

= The absence of the ZCNF and CDM keyword parameters indicates that this is a 
single-thread DTF configuration and that the configurator load modules reside 
in $Y$LOD on OS/3REL. 

m= The NAMEREC and AUDCONMF files reside on volume DISKO8, on disk unit 51. 
The online IMS load module is to be placed on the same volume in a file 
named IMSLOD. 

m Configurator input is in $Y$SRC on SYSRES (LIBS default); the name of the 
input module is IMSSRC. 

m The online load module is to be named IMSS90. (This contro! stream will not 
produce a load module; however, the link stream is generated in the 
configuration step.) 

= The name of the CCA object module is IMS1; it is stored in $Y$OBJ on 
OS/3REL. 

Example 3: 

1 10 16 72 

// JOB IMSMT,,11E0® 

// IMSCONF ZCNF=MT, IMSFIL2=(51,DSK100,AUDIT1), X 

// IMSFIL3=(51,0SK100,DATA1), INIT=(S, , 100,NO,NO) 

/& 

// FIN 


Example 3 generates all five job streams for a multithread configuration. 


The audit file, named AUDIT 1, and the continuity data file, named DATA1, are 
on volume DSK 100 on disk unit 51. The NAMEREC file is on SYSRES. 


The NAMEREC file is to be scratched and reinitialized. Block size is defaulted 
to 6144, and 100 blocks are to be allocated. The AUDIT1 and DATAT1 files 
are assumed to have been previously allocated. 


Input is from cards. 
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Example 4: 


// JOB LIST 

// IMSCONF LST=(A),CNFJCS=(,,CNF) 
/& 

// FIN 


Example 4 does not run any of the configurator control streams but provides a 
listing of the NAMEREC file directory. 


= No configurator input is present. 
m= The min parameter of the JOB statement is not required. 
= The NAMEREC file is assumed to be on the system resident volume (SYSRES). 


a If you specify the CDM=YES parameter, you must assign a MIRAM NAMEREC 
file; otherwise, an ISAM NAMEREC file is assumed. If the type of the 
NAMEREC file is not consistent with the CDM specification, a fatal error 
results. 


m If the NAMEREC file is not on SYSRES, you must use the IMSFIL or IMSFIL1 
parameter. 


m The CNFJCS parameter avoids a CCA linkage. 


4.3. INPUT TO THE IMS CONFIGURATOR 


In the third step of the configuration process performed by the IMSCONF jproc, the IMS 
configurator program itself is executed. The configurator generates a number of tables 
and writes them to the NAMEREC file for the online use of the IMS system being 
configured. 


The configurator program is controlled by the runstreams generated by the IMSCONF 
jproc and by input from a card reader or from a source library on disk. After analyzing 
its input, the configurator collects the modules required by your operation and generates 
and lists error diagnostics from the configuration process. When an _ error-free 
configuration run has been made, a source module is produced that is assembled and 
linked in the last two steps of the configuration process. 


Input to the configurator is organized in 12 logical sections. Some sections may be 
repeated. A prescribed sequence must be followed in submitting the various sections of 
configurator input. 


4 


t 


—_> 
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The 12 sections of configurator input are as follows: 


NETWORK Section 
Defines the ICAM network for IMS; must be the first section. 


GENERAL Section 
Defines overall configuration parameters. 


OPTIONS Section 
Defines optional IMS modules to be included in configuration. 


TIMEOUTS Section 
Defines various time-out values. 


FILE Section 
Describes each user data file to be accessed by IMS; coded once for each file. 


TERMINAL Section 
Further defines terminals already included in this IMS network. 


TRANSACT Section 


Supplies transaction code data to the configurator; coded once for each 
transaction. 


ACTION Section 


Describes the actions to be used in this configuration; coded once for each 
action. 


PROGRAM Section 


Describes the user action programs to be included in this IMS configuration; 
coded once for each action program. 


LANGUAGE Section 
Creates a UNIQUE lexicon record in the NAMEREC file. 


LOCAP Section 


Identifies a remote system to which transactions can be routed (multithread 
only). 


DRCRDMGT Section 
Defines the user interface with defined record management. 


Input for the configurator falls into two categories: repeatable and nonrepeatable 
sections. The nonrepeatable group consists of the NETWORK, GENERAL, OPTIONS, 
TIMEOUTS, and DRCRDMGT sections, and the repeatable sections are FILE, TERMINAL, 
TRANSACT, ACTION, PROGRAM, LANGUAGE, and LOCAP. 


The NETWORK section must be the first section specified. The other nonrepeatable 
sections except DRCRDMGT follow the NETWORK section. 
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The repeatable group of sections follows the nonrepeatable group. All repeated sections 
must be specified consecutively; i.e., all FILE sections together, all TERMINAL sections 
together, etc. 


Although it is a nonrepeatable section, the defined record management (DRCRDMGT) 
section must be the last section specified in the configuration. 


Configurator sections and parameters applicable to single-thread and multithread IMS 
are summarized in Table 4-1. Following the table and an example of input coded for a 
multithread configuration, each section is discussed in detail. Appendix A presents the 
statement and coding conventions used for describing and presenting input to the IMS 
configurator. 


Table 4-1. Summary of Sections and Parameters Input to IMS Configurators (Part 1 of 7) 


le-Thread | Multi 


NETWORK — [ Mandatory, nonrepeatable section. Must be the 
first section input 


Specifies configuration of batch transaction 
processor. 


CONFID X xX identifies current IMS system in configurator- 
generated records for the NAMEREC file 

CUP Xx x Gives LOCAP-name for this IMS program in a 
global network definition 


KATAKANA Specifies Katakana support 
NAME | x |x| Species CCA name for ICAM network | Specifies CCA name for ICAM network 


PASSWORD iL ae ok oe Specifies password for ICAM network 
TERMS + Specifies maximum number of online terminals 


GENERAL |x | nonrepestabi section 


AUDITNUM Specifies number of audit records required in 
AUDFILE (multithread) or AUDCONF (single-thread) 
CHRS/LIN aC Specifies message line length 


DDPBUF Specifies size of buffer required for 
distributed data processing 


DDPSESS Specifies number of DDP sessions that 
can be active at one time 
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Table 4-1. Summary of Sections and Parameters Input to IMS Configurators (Part 2 of 7) 


Single-Thread | Multithread 
Parameters 
IMS IMS 


GENERAL INBUFSIZ xX x 
(cont) 


LNS/MSG Specifies number of lines per message 
MAXCONT Specifies largest continuity data area 






Specifies the size of the input message 
staging buffer to be allocated at IMS 
start-up time 



























TRANLEN Xx Specifies maximum number of characters 
in transaction code and lexicon names 
UCHAR xX Specifies urgent priority on input messages for 







multithread IMS system 


pee als ss 


_ 


_ eS 


Le Allows IMS access to DMS data bases 
FASTLOAD wee a Allows use of fast load feature 


= 


ps) 


OPTIONS 


Includes continuous output capability in this 





configuration 

























Provides support for downline loading user 
programs to a UTS terminal 


Specifies inclusion of file updating modules in 
IMS configuration 


Allows interruption of output from UNIQUE 
LIST command 


Provides capability of clearing screen of 
unprotected and protected data 


Provides capability of displaying messages 
at top or bottom of screen 


Provides support for console transaction processing 
Allows record locking across actions 


x 
x 
x 
x 
: 


OPCOM 
RECOVERY 


RESEND 
_ 













Specifies configuration of support for ZZRSD 
terminal command 


Specifies maximum number of screen formats 
to remain resident between screen format 
services calls 
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@ Table 4-1. Summary of Sections and Parameters Input to IMS Configurators (Part 3 of 7) 


Sree nee 
Parameters Remarks 


OPTIONS 
(cont) 
SNAPED Specifies whether snapshot dumps are to 
be printed with or without an edited 
directory 


Specifies recording of statistical information 
at shutdown time 


SUBPROG Xx x Provides support for user-written subprograms 


TOMFILE Specifies that terminal output messages 
are written to the TOMFILE for online 
recovery 


TOMTRCE Specifies that terminal output messages written to 
the TOMFILE are also written to the trace 
file for use in offline recovery 


UNIQUE Specifies whether UNIQUE language modules 
& are to be configured and whether the 
ZU4CIN interpreter module is resident 


Specifies whether capability for unsolicited 
output is configured (SEND function, SWTCH command) 


TIMEOUTS i | eel Nonrepeatable section 


ACTION x xX Specifies maximum time action program may have 
control 


STATUS Xx Specifies waiting period for automatic status 


message at terminal in multithread IMS system 


Required, repeatable section: one for each user 
data file accessed; immediately follows last of 
nonrepeatable sections except DRCRDMGT 


file-name ae a Positional parameter 


FILETYPE Always required; specifies type of user data file 
described 
CAFILE x x Specifies that the file is a common storage 
area file and makes the file resident in 
main storage 
7 CUPDATE x Xx Specifies updating of disk images when the 
common storage area file is updated 
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Table 4~1. Summary of Sections and Parameters Input to IMS Configurators (Part 4 of 7) 





Single- Thread sig 


Remarks 


DELETP Specifies physical deletion of MIRAM file 
records 
LOCK Specifies record lock for transaction or update 


OUTPUT Allows output processing for a dedicated 
sequential MIRAM file 


Specifies the primary key of a multikeyed 
MIRAM file 


Specifies whether file is to be traced for- 
offline recovery 


(DTF or RIB Data management DTF or RIB keywords 

g 
keyword describing this data file are input immediately 
parameters) following the other FILE parameters 


TERMINAL 


terminal-id Positional parameter specifying id of terminal 
described by subsequent keywords 





IMSREADY Specifies whether this terminal is to receive 
the IMS READY message at start-up time 


MASTER Specifies whether this is the master terminal 
of IMS network 


Specifies whether this terminal is to receive 
notice of unsoloicited output at the end of an 
action or a transaction 


URGENT Specifies whether all messages input from this 
terminal have urgent priority 


TRANSACT Optional; mat be omitted only if user has no 
transactions to describe, in which case the 
UNIQUE keyword of OPTIONS section must 
be specified as YES, RES, or TRAN; otherwise. 
must be coded once for each transaction 


trans-code Positional parameter; required to supply 
transaction code to configurator 


ACTION Specifies name of action program to be scheduled 
for this transaction 
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Table 4-1. Summary of Sections and Parameters Input to IMS Configurators (Part 5 of 7) 


Section Parameters 


TRANSACT LOCAP 
(cont) 
UNDEF x x 
enters a transaction code that has not been 
defined to IMS 


URGENT Specifies whether transactions with this code 
are urgent 


Optional; may be omitted only if user has no 











Single-Thread | Multithread 















Specifies a remote system where this 
DDP transaction is sent for processing, 
using directory routing 
















Specifies whether this transaction is to 
receive control when the terminal operator 


ACTION 
actions to describe, in which case the UNIQUE 
keyword of the OPTIONS section must be 

specified YES, RES, or TRAN; otherwise, must 
be coded once for each action 












Positional whether all action programs for this 
action are reentrant 







ALLRNT 
BYPASS 


CDASIZE 


a nae 


Specifies whether all action programs for this 
action are reentrant 








Specifies number of times this action may be 
bypassed before it must be initiated 


Specifies size of continuity data area for this action 


Specifies name of data definition record 























associated with defined file for this action 


Specifies name of defined file accessed by this 
action; required if DDRECORD specified 


Specifies editing requirements on input 
messages for this action 





Specifies FCC editing requirements for input 
messages from UTS or workstation terminals 






Names conventional files to be accessed or 
created by this action 
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Table 4-1. Summary of Sections and Parameters Input to IMS Configurators (Part 6 of 7} 


. Single-Thread | Multithread 
Section Parameters Remarks 
ACTION MAXSIZE x x Specifies size of largest nonresident action 
(cont) program for this action 
MAXUSERS Specifies the maximum number of users that 
may process this action concurrently 
OUTSIZE ie Specifies length of output message for this action 
SHRDSIZE q Specifies size of volatile data area shared by 
COBOL action programs involved in this action; 
not used for BAL or RPG Il action programs 
TRANSLAT Xx X Specifies lowercase-to-uppercase translation 
on input messages for this action 
WORKSIZE it el a Specifies size of work area for this action 


PROGRAM Optional; may be omitted if user has no action 
programs to describe, in which case the 
UNIQUE keyword of the OPTIONS section must 
be specified YES, RES, or TRAN; otherwise, 
must be coded for each action program. 


program-name Positional parameter; required to name the 
action program described 

ERET Specifies whether control is returned to this 
action program in case of error 

RESIDE Specifies whether this action program is resident 

SUBPROG Specifies whether this is a subprogram 


TYPE Specifies whether this action program is 
reentrant, shared code, or serially reusable 








LANGUAGE Optional, repeatable section which allows 


user to define UNIQUE lexicons 


lexicon- Specifies lexicon and transaction name 
name 


language- Specifies words, characters, and delimiters 
element from the standard lexicon, and their 
replacements 
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Table 4-1. Summary of Sections and Parameters Input to IMS Configurators (Part 7 of 7) 


Th 
| secon | raters | a s nMs sag 


Required when distributed data processing 
is used; defines the remote system where 
transactions are processed; repeatable 


Specifies locap name of the remote system 


Specifies a special character that represents 
the remote system where transactions are 
processed, using operator routing 


DRCRDMGT Optional, nonrepeatable; follows last of 
repeatable sections 


RESIDE x Specifies whether defined record management 
is resident or transient 

UPDATE xX Specifies whether defined record management 
file updating functions are to be included in this 
IMS configuration 


Not applicable 





LEGEND: 





x = Applicable 


In most cases, the configurator generates default values for parameters you omit. 
Default values are shaded in the section formats or are noted in the parameter 
descriptions. Some default values are dependent on your specifications for other 
parameters. For instance, if you specify CONTOUT=YES in the OPTIONS section, you 
automatically get UNSOL=YES because the unsolicited output module is needed for 
continuous output. However, the printout of the input source does not show the actual 
default values that the configurator generates in these special cases. The listing shows 
the normal default value for each parameter you omit. 


Figure 4-6 illustrates configurator input prepared for a multithread IMS system. In a 
single-thread system, the UCHAR, STATUS, and URGENT parameters do not apply. 
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NETWORK 
GENERAL 
OPTIONS 


TIMEOUTS 
FILE 


FILE 


FILE 


TERMINAL 
TERMINAL 
TERMINAL 
TERMINAL 
TERMINAL 
TERMINAL 
TERMINAL 
TERMINAL 
TERMINAL 
TRANSACT 
TRANSACT 
TRANSACT 
TRANSACT 
TRANSACT 
TRANSACT 
TRANSACT 





NAME=IMS4 PASSWORD=IMSPASS CONFID=1 TERMS=20 
CHRS/LIN=8@ LNS/MSG=12 UCHAR=* MAXCONT=1792 
UNIQUE=YES FUPDATE=YES SUBPROG=YES CONTOUT=YES 
RECOVERY=ALL 
ACTION=12@ STATUS=15 
DUEOUT FILETYPE=ISAM LOCK=TR 
IOROUT=ADDRTR KEYLEN=17 RECFORM=FIXBLK RECSIZE=22 IOREG=(8) 
PCYLOFL=10 KEYLOC=1 WORK 1=DUEOUT 
IOAREA1=DUEQUT TYPEFLE=RANSEQ BLKSIZE=1514 
PRODFIL FILETYPE=ISAM LOCK=TR 
IOROUT=ADDRTR KEYLEN=17 RECFORM=FIXBLK RECSIZE=8@ IOREG=(8) 
PCYLOFL=2@ KEYLOC=@ WORK 1=PRODFIL 
IOAREA=PRODFIL BLKSIZE=257 
CATALOG FILETYPE=ISAM LOCK=TR 
IOROUT=ADDRTR KEYLEN=17 RECFORM=FIXBLK RECSIZE=30 IOREG=(8) 
PCYLOFL=10 KEYLOC=1 WORK1=CATALOG 
IOAREA1=CATALOG TYPEFLE=RANSEQ BLKSIZE=1017 
CUSTFIL FILETYPE=ISAM LOCK=TR 
IOROUT=ADDRTR KEYLEN=5 RECFORM=FIXBLK RECSIZE=80 IOREG=(8) 
PCYLOFL=10 KEYLOC=0 WORK1=CUSTFIL 
IOAREA1=CUSTFIL TYPEFLE=RANSEQ BLKSIZE=1022 
PCYLOFL=10 KEYLOC=0 WORK1=CUSTFIL 
IOAREA1=CUSTFIL TYPEFLE=RANSEQ BLKSIZE=1022 
FILETYPE=ISAM LOCK=TR 
IOROUT=ADDRTR KEYLEN=17 RECFORM=FIXBLK RECSIZE=22 IOREG=(8) 
PCYLOFL=10 KEYLOC=1 WORK1=DUEIN 
IOAREA1=DUEIN BLKSIZE=758 TYPEFLE=RANSEQ 
SAMDISK FILETYPE=SAMD 
BLKSIZE=1024 IOAREA1=SAMDISK TYPEFLE=OUTPUT WORKA=YES 
VENDOR FILETYPE=DAMR LOCK=TR 
BLKSIZE=256 KEYLEN=0 READID=YES WRITEID=YES 
TRM1  MASTER=YES 
TRM2 UNSOL=ACTION URGENT=YES 
TRM3. = IMSREADY=NO 
TRM4 
TRM5 
TRM6 
TRM7 
TRM8 
TRM9 
CUST ACTION=AP1 
PROD ACTION=AP2 
AP3 
AP4 
AP5 
SAMD ACTION=AP6 
ROLL ACTION=AP7 


Figure 4-6. Sample Configurator Input (Part 1 of 2) 














UP-8364 Rev. 7 


SPERRY UNIVAC OS/3 
IMS SYSTEM SUPPORT FUNCTIONS 





2 ACTION 


ACTION 
ACTION 
ACTION 
ACTION 


ACTION 


ACTION 


PROGRAM 
PROGRAM 
PROGRAM 
PROGRAM 
PROGRAM 
PROGRAM 
PROGRAM 
PROGRAM 
// FIN 


& 4.3.1. Identifying the ICAM Network Definition — the NETWORK Section 


FILES=CUSTFIL WORKSIZE=256 OUTSIZE=80 TRANSLAT=YES 

FILES=PRODFIL WORKSIZE=256 OUTSIZE=86 TRANSLAT=YES 

OUTSIZE=8@ WORKSIZE=256 TRANSLAT=YES 

OUTSIZE=80 WORKSIZE=256 TRANSLAT=YES 

OUTSIZE=80 WORKSIZE=256 TRANSLATE=YES 
FILES=CATALOG 

OUTSIZE=80 WORKSIZE=512 CDASIZE=256 TRANSLAT=YES 
FILES=CUSTFIL,SAMDISK 


OUTSIZE=80 WORKSIZE=512 CDASIZE=256 TRANSLAT=YES 
FILES=PRODFIL, VENDOR 
ERET=YES TYPE=RNT 
ERET=YES TYPE=RNT 
ERET=YES 
ERET=YES 
ERET=YES 
ERET=YES TYPE=RNT 
ERET=YES TYPE=RNT 
ERET=YES SUBPROG=YES 


Figure 4-6. Sample Configurator Input (Part 2 of 2) 


4-45 





The NETWORK section identifies the ICAM network used by IMS, provides the 
configuration identifier used in the NAMEREC file, and supplies information needed to 
configure this IMS load module for batch transaction processing. The NETWORK section 
cannot be repeated and must be the first section specified. 


Format: 


NETWORK] BATCH=(n 





YES 


CONFID=n 
[CUP=Locap- label ] 


leas 





res] 





pe - rl 
i : 





[PASSWORD=password-name ] 
TERMS=max-no-terminals 


Example: 


@ NETWORK 


BATCH=YES NAME=NET3 PASSWORD=SESAME 


CONFID=3 CUP=IMS9 TERMS=75 
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4.3.1.1. Specifying Batch Processing of Transactions (BATCH) 


The BATCH keyword parameter specifies whether this IMS single-thread or multithread 
system is to be configured for batch processing of transactions. If batch processing is 
specified, this keyword determines the number of batch pseudoterminals that the 
configurator will generate and the number of input source modules that may be 
processed at one time. Batch processing is described in Section 6. 


BATCH=n 

Specifies that the batch transaction processor is to be configured in this IMS 
system and stipulates the number of batch pseudoterminals the configurator is 
to generate. The completion, n, is a decimal number in the range 1-4; it 
represents the number of batch pseudoterminals and determines the maximum 
number of batch input source modules and data sets that may be submitted at 
one time to the batch transaction processor. Only one batch pseudoterminal 
can be generated in a single-thread system. 


NOTE: 


If the value specified exceeds 1 for single-thread IMS or 4 for multithread IMS, the 
configurator assumes a default value of 1 for single-thread and 4 for multithread. It 
also issues a diagnostic message in the configurator listing (Figure 4-7). 


BATCH=NO 
Specifies that the batch transaction processor is not to be configured and is 
the default assumption. 


BATCH=YES 
Specifies that the batch transaction processor is to be configured, that one 
batch pseudoterminal is to be generated, and that a single source input module 
will be processed at a time. The single-thread user may specify BATCH=YES 
or BATCH=1, both specifications having the same effect. 


4.3.1.2. Specifying the Configuration Identifier (CONFID) 


The purpose of the CONFID keyword parameter, which is always required, is to identify 
all configurator-generated records and control tables in the NAMEREC file with the 
specific IMS load module for which they are created. One NAMEREC file may contain 
records from as many as 255 distinct IMS configurations; the configuration identifier, or 
ID, allows each online IMS load module to single out the records it needs. (Configuration 
IDs are specified as decimal integers in the range 1-255.) Password definition records, 
data definition records, and input edit tables can be used by various IMS load modules 
since they do not necessarily relate to a specific configuration. 


In specifying the CONFID keyword parameter, you may reuse the configuration ID 
specified for a previously configured IMS load module that used the same NAMEREC 
file. When you do so, the records newly generated by the current configurator run 
replace those already so identified in the NAMEREC file, and an appropriate diagnostic 
message is issued. (Refer to Figure 4-7.) 
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If you omit the CONFID keyword parameter or make an invalid specification, there is no 
default assumption. The IMS configurator terminates and issues the error message 
illustrated in Figure 4-8. 


CONFID=n 
Specifies a 1- to 3-digit decimal integer in the range 1-255 that uniquely 
identifies all records generated for the NAMEREC file by the current 
configurator run with the IMS load module being configured. 


IMS makes another use of the configuration identifier specified with the CONFID 
keyword - to uniquely identify DTF and CDIB/RIB object modules generated by multiple 
configuration runs in the assembly step. The configuration identifier becomes part of the 
object module name, which takes the form: 


ZS#1 nnn (for single-thread DTF configurations) 

ZQ#I@nnn (for multithread DTF configurations) 

ZS8$1@nnn (for single-thread CDM configurations) 

ZQ$1@nnn (for multithread CDM configurations) 
where: 

nnn 


Is the 3-digit configuration identifier (zero-filled, if necessary) specified with the 
CONFID keyword parameter for the configuration to which this DTF or 
CDIB/RIB object module applies. 


4.3.1.3. Relating the IMS Program to a Global Network (CUP) 


The CUP keyword parameter associates the online IMS program with a global network 
via the label of a LOCAP macro in the ICAM network definition. 


CUP=Locap- label 
Names the IMS program as given on the label of a LOCAP macro in the 
network definition. 


4.3.1.4. Specifying Katakana Support (KATAKANA) 


The KATAKANA parameter indicates whether Katakana characters are to be supported. 
The Japanese use Katakana to represent non-Japanese words. IMS supports the use of 
Katakana characters in transaction codes, lexicons created in LANGUAGE sections, 
defined file names, data definition records, routing characters, and urgent priority 
characters in input messages. 
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Indicates that the IMS system being configured is not to include Katakana 
support. This is the default assumption. 


KATAKANA=YES 
Indicates that the IMS system being configured is to include Katakana support. 


4.3.1.5. Specifying the Name of the ICAM Network (NAME) 


The NAME keyword parameter names the ICAM network used by IMS. The name 
specified must agree with either: 


= the name specified via the CCAMOD keyword parameter of the COMMCT section 
input to the SYSGEN process when the [CAM symbiont is created; or 


m= the name specified as the label of the CCA macro in the COMMCT section. (Refer 
to Section 2.) 


NAME=network -name 
Specifies the 1- to 4-character alphanumeric name of the ICAM network. The 
first character must be alphabetic. 


If the NAME keyword parameter is omitted, the configurator assumes that the 
network-name is IMS4. 


4.3.1.6. Identifying the Network Password (PASSWORD) 


This keyword parameter identifies the password associated with the ICAM network. If a 
password is assigned in the network definition (via the PASSWORD operand of the 
CCA macro), you must code the PASSWORD parameter in the configurator NETWORK 
section, and the two specifications must agree. If a password is not assigned in the 
network definition, this parameter may be omitted. 


PASSWORD=password-name 
Specifies the 1- to 8-character alphanumeric password assigned to the 
network when the ICAM load module was generated. The first character must 
be alphabetic. 


If the PASSWORD keyword parameter is omitted, but a password was assigned to 
the network definition when the ICAM symbiont was created, the ICAM network 
will not be initialized or accessible to your IMS load module. 


4.3.1.7. Limiting the Number of Online Terminals (TERMS) 


The TERMS parameter sets a limit on the number of terminals that can be online at one 
time. It is required for both dedicated and global networks. 
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With a dedicated network, you must specify a value equal to or greater than the 
number of terminals listed in your ICAM network definition. You might want to specify 
more than the number of terminals in the network definition so you can regenerate 
ICAM (with additional terminals) without reconfiguring IMS. 


With a global network, you must specify a value equal to or greater than: 


™ the number of static session terminals named in SESSION macros in the network 
definition, plus 


m the number of dynamic session terminals defined to the configuration in TERMINAL 
sections (4.3.6), plus 


m= the maximum number of other dynamic session terminals allowed to be online at 
the same time. 


TERMS=max-no-terminals 
Stipulates the maximum number of terminals allowed to be online at one time. 


If omitted, the configurator terminates with the message: 
***TERMS MISSING OR INVALID - KEYWORD VALUE REQUIRED*** 


When you use a global network, IMS reserves a terminal slot for each static session 
terminal in the network definition and each dynamic session terminal that you define to 
the configurator in a TERMINAL section. The remaining slots - that is, the difference 
between the number you specify with the TERMS parameter and the number of 
reserved terminal slots - are available for the remaining dynamic session terminals. 


For example, if you have 75 terminals in your network, of which 25 are static session 
terminals and 10 are defined in TERMINAL sections, 35 terminals slots are reserved at 
all times. If you specify TERMS=50, 15 terminal slots are available for the 40 other 
dynamic session terminals in your network. 


Also, when you start up IMS with STARTUP=WARM or STARTUP=COLD, any 
dynamic session terminal that was in the middle of an updating transaction when IMS 
last terminated has a slot reserved for it. The terminal can sign on (S$SON) and issue 
the DLMSG transaction code to retrieve the output message of its last completed 
transaction. After the terminal signs off (S$SOFF), the terminal slot is released. 


In the previous example, suppose two of the dynamic session terminals not listed in 
TERMINAL sections are in the middle of updating sessions when IMS terminates, and 
you start up IMS again with a warm or cold start. IMS reserves slots for the two 
terminals, leaving only 13 slots for the other 38 terminals in the network. 


4.3.1.8. Sample Configurator Output for the NETWORK Section 


Consider the portion of a configurator listing illustrated in Figure 4-7 and assume that 
the first line represents input for the NETWORK section in a single-thread configuration. 
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The specification of the BATCH keyword (BATCH=2) exceeds the maximum for 
single-thread; this causes the error message on the second line to be issued and the 
default value (BATCH=1) to be assumed, as shown on the bottom line. 


The configuration identifier specified (CONFID=7) evidently is a reuse of the ID specified 
for a previously configured IMS load module using the same NAMEREC file. The third, 
fourth, and fifth lines of the listing represent the diagnostic message issued to notify 
you of the replacement of the NAMEREC file records from the earlier run by those 
generated in this run. See also 4.2.3 and Figure 4-5. 


00001 NETWORK NAME=IMS1 PASSWORD=IMSNET@1 BATCH=2 CONFID=7 TERMS=20 
***TOO MANY BATCH TERMINALS - DEFAULT VALUE ASSUMED*** 
THIS CONFIGURATION REPLACES THE FOLLOWING ONE: 
CNF-ID CNF-NETW CNF-DATE CNF-TIME CNF-VERS CNF-ERRORS 
0007 IMS1 61/11/82 14:41:58 VER8.0.08-ST 0005 
SECTION NETWORK INPUT AND DEFAULT VALUES 
NAME IMS1 INPUT 
PASSWORD IMSNETO1 INPUT 
CONFID 7 INPUT 
cuP IMS3 INPUT 
TERMS 20 INPUT 
BATCH 1 DEFAULT 
NETWORK 





Figure 4-7. Configurator Listing for BATCH Keyword Specification Error and Specification of Previously Used 
Configuration Identifier (NETWORK Section) 


Figure 4~8, a portion of another configurator listing, illustrates the output made when 
the CONFID keyword parameter is not specified. The first line represents the NETWORK 
input, the second shows the error message issued by the configurator, and the 
following lines represent a tabulation of the values input or assumed by default for the 
section. 


00001 NETWORK NAME=IMS1 PASSWORD=IMSNET@1 BATCH=2 TERMS=20 
***NO CONFID SPECIFIED - CONFIGURATION TERMINATED*** 
SECTION NETWORK INPUT AND DEFAULT VALUES 
NAME IMS1 INPUT 


PASSWORD = IMSNET®@1 INPUT 
CONFID = ***ERROR DEFAULT 
BATCH 2 INPUT 
TERMS 20 INPUT 
NETWORK 





Figure 4-8. Configurator Listing for Omission of CONFID Keyword Parameter (NETWORK Section) 
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4.3.2. Specifying Overall Configuration Parameters — the GENERAL Section 


The GENERAL section defines certain general characteristics of this IMS configuration. 
This section is optional and nonrepeatable. 


Format: 


GENERAL ieee 


hegua 
pee 


[INBUFSIZ=n] 
pede 


ny 


[MAXCONT=n] 


(“eB 














[UCHAR=c] 
Example: 
GENERAL SUBTASKS=3 CHRS/LIN=80 LNS/MSG=16 UCHAR=* MAXCONT=400 


4.3.2.1. Designating Number of Audit Records (AUDITNUM) 


This keyword specifies the number of audit records required per terminal in the audit file 
(the AUDFILE for multithread IMS; the AUDCONF file for single-thread). The audit file, as 
shown in the following diagram, is a partitioned system access technique (SAT) file, 
containing as many partitions as there are terminals in your network. Each partition is 
allocated to one of the terminals and is formatted to contain the number of records 
specified by the AUDITNUM keyword parameter. The records written to the file are the 
before-images of records to be updated. IMS also writes control records to this file at 


shutdown time. 
PARTITION 1 PARTITION 2 
PARTITION 3 PARTITION 4 ei 


At rollback points and transaction termination, the current record pointer for the active 
partition is reset to point to the first record of the partition. If a transaction generates 
more before-images than specified by the AUDITNUM keyword before writing a rollback 


point or before it terminates, it is canceled and the record pointer for the active partition 
reset. 














TERMINAL 
1 






TERMINAL 
3 
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AUDI TNUM=n 
Specifies maximum number of records required to contain all before-images 
written from one terminal to the audit file between two rollback points or 
between initiation of one transaction and its termination (whichever occurs 
first). The default assumption is 20 records for either single-thread or 
multithread IMS. If file updating is not configured, specify AUDITNUM= 1. 


For details on the partitioned SAT file, refer to the OS/3 supervisor user guide, 
UP-8075 (current version). 
4.3.2.2. Specifying Message Line Length (CHRS/LIN) 


The CHRS/LIN keyword parameter determines the number of characters per line in the 
standard IMS message. 


CHRS/LIN=n 


Specifies the standard number of characters per line for your IMS applications. 
The default value is 80. 


4.3.2.3. Specifying DDP Buffer Size (DDPBUF) 


The DDPBUF keyword parameter specifies the size of the buffer required for distributed 
data processing (multithread IMS only). 


DDPBUF=n 
Specifies the length of the DDP buffer. The default assumption is 1024. 


You should calculate the buffer size as follows: 


Length of 80 to 90 percent of your messages (including DICE) + 16 bytes for 
ICAM header + 70 bytes for DDP protocol 


The maximum buffer size you can specify is 4352 bytes. If the buffer size you specify is 
not large enough to handle all messages, you must specify FEATURES= (SEGMENTS) 
on the CCA macro in your network definition. 


4.3.2.4. Specifying Number of DDP Sessions (DDPSESS) 
The DDPSESS keyword parameter specifies the maximum number of distributed data 


processing sessions that can be active in this system simultaneously (multithread IMS 
only). It is the total of: 


™ transactions this system sends to a remote system for processing; and 
= transactions sent to this system by another for processing. 
DDPSESS=n 


Specifies the maximum number of DDP sessions that can be active at one 
time. The default is 5. Specify a value between 2 and 25. 
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4.3.2.5. Specifying Input Message Buffer Size (INBUFSIZ) 


The INBUFSIZ parameter specifies the size of the input message staging area that IMS 
allocates at start-up time. You calculate this specification differently for single-thread 
and multithread IMS, and the configurator generates different default values for 
single-thread and multithread systems when you omit this parameter. The reason for the 
different calculation is that the input message staging area requires a single buffer in a 
single-thread system and multiple buffers in a multithread system. In either case, the 
INBUFSIZ value should be a multiple of 8. 


INBUFSIZ=n 
Specifies the length of the input message staging area. 


1. Single-thread 


In a single-thread system, the default value is 2048. The maximum value 
you can specify is 32,760. 


When you include the INBUFSIZ parameter in a single-thread IMS system 
that runs with transient ICAM, the specification must be equal to or 
greater than the size of the ICAM buffer. 


If you have action programs that use delayed internal succession or 
output-for-input queueing, your input message staging buffer must be large 
enough to contain the largest output message generated by these 
programs. Use the following formula to calculate the %INBUFSIZ 
specification: 


(CHRS/LIN+4) « (LNS/MSG) + 24 + (5 * (number of FCCs)) 


where the number of field control characters (FCCs) is the maximum 
number of FCCs that appear in a message. Ignore the 5 * (number of 
FCCs) portion of the formula if your network does not include FCC 
terminals. The result of the entire expression is double-word aligned. 


When you use screen format services, your input message staging buffer 
must be double the output area length needed to build your largest screen 
format. To determine the INBUFSIZ, use the formula described under the 
OUTSIZE parameter for screen format support (4.3.8.13) and double the 
value obtained. Use this formula regardless of whether your screen 
formats are built in dynamic main storage or in the output message area. 


2. Multithread 


When you omit the INBUFSIZ parameter in multithread IMS, the 
configurator uses the larger value from one of the following formulas to 
generate an input message staging buffer: 


(standard message size) 


F * (number of terminals) 


((standard message size)*2) + (1024 for every 5 terminals above 30) 
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where: 
standard message size = (CHRS/LIN+4) « (LNS/MSG) + 24 


The default message value generated by the configurator is usually 
adequate. However, depending on the number of transactions you have 
and the sizes of your messages, you may find that a smaller or larger 
INBUFSIZ specification is optimum for your system. An inadequate input 
message staging area size can degrade performance and cause deadlock. 


4.3.2.6. Specifying the Number of Lines per Message (LNS/MSG) 


The LNS/MSG keyword parameter determines the number of lines in the standard IMS 
message. 


LNS/MSG=n 
Specifies the standard number of lines per message for your IMS applications. 
The default value is 12. 


4.3.2.7. Defining Largest Continuity Data Area (MAXCONT) 


The MAXCONT keyword parameter defines the size of the largest continuity data area 
in this IMS configuration. 


MAXCONT=n 
Specifies the number of bytes in the largest continuity data area for any action. 
This value should be a multiple of 8. The minimum value you should specify is 
512 if UNIQUE and DLLOAD are not configured, 1024 if only DLLOAD is 
configured, and 1792 if UNIQUE is configured. 


If MAXCONT is omitted, all action programs (including UNIQUE) are scanned, and 
the size of the largest continuity data area is used. If UNIQUE is included and the 
largest CDASIZE specified for a user action program is less than 1792, IMS 
assumes MAXCONT= 1792 and issues a diagnostic message. 


NOTE: 


MAXCONT is used to determine the logical block size for the continuity data file 
(CONDATA) in a multithread configuration or the continuity data partition of the 
AUDCONMF file in single-thread. If you specify both MAXCONT=O and UNIQUE=NO, the 
continuity data file or partition is not allocated. If UNIQUE capability is included, the 
UNIQUE CDA requirements override a MAXCONT=O specification. 
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4.3.2.8. Specifying Maximum Length of Transaction Code Names (TRANLEN) 


The TRANLEN keyword parameter specifies the maximum number of characters allowed 
in transaction code and lexicon names (multithread IMS only). 


TRANLEN=n 
Specifies the maximum length for transaction codes and lexicon names. You 
must specify a value for n in the range 5-8. The default is 5. 


If the transaction code specified in the TRANSACT section is longer than the value 
specified for n (or the default value), IMS truncates the code to n characters (or 5). 


4.3.2.9. Specifying Urgent Priority on Input Messages (UCHAR) 


The UCHAR keyword parameter specifies which character designates urgent priority 
when used as the first character of an input message. It is not available to the 
single-thread user. 


UCHAR=c 
Designates the character which, when included as the first character of an 
input message, notifies IMS that the message has urgent priority. If omitted, 
no urgent priority character is recognized. We recommend that this be a 
special character so that all alphanumerics may be used as the first character 
of normal messages. 


If KATAKANA=YES is specified in the NETWORK section, this character may 
be a Katakana character. 


In a multithread IMS system, an input message can be given urgent priority in any of 
these ways: 


m= The first character of the message has been designated as the urgent priority 
character. 


m= ~§=«The terminal from which the message is entered has been designated as an urgent 
priority terminal (4.3.6). 


= The transaction code of the message has been designated as an urgent priority 
transaction code (4.3.7). 


4.3.3. Including Optional IMS Modules - the OPTIONS Section 


The OPTIONS section of the configurator input specifies whether certain optional IMS 
modules are to be included in this configuration.The OPTIONS section is optional and 
nonrepeatable. 
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Format: 


OPTIONS 





(single-thread) 
(mul tithread) 









continued 
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@ OPTIONS UNIQUE=/ NO 





Example: 


OPTIONS UNIQUE=TRAN RECOVERY=ALL FUPDATE=YES 
TOMFILE=YES CONTOUT=YES SNAPED=YES 


4.3.3.1. Including Continuous Output Capability (CONTOUT) 


The CONTOUT keyword parameter determines whether the capability for continuous 
output is to be included in this configuration. It is available for single-thread and 
multithread IMS. You must configure continuous output in order to: 


™ print continuous output transactions, either at the originating terminal or at a 
different terminal; 


m address output to an auxiliary device; 

@ m ~§disconnect a single-station dial-in line following delivery of an output message; or 
= downline load a user program to a UTS terminal. 
If you specify CONTOUT=YES, IMS also includes the capability for unsolicited output in 
your configuration, whether or not you also specify UNSOL=YES, because continuous 
output functions require the availability of the unsolicited output module. Continuous 


output capability is automatically included if you specify downline loading by means of 
the DLLOAD parameter. 





Specifies that continuous output capability is not to be included in this 
configuration and is the default assumption unless downline loading capability 
is configured (DLLOAD=YES). If specified along with DLLOAD=YES, 
CONTOUT=NO is ignored. 


CONTOUT=YES 
Specifies that continuous output capability is to be included in_ this 
configuration. 
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4.3.3.2. Providing Support for Downline Loading (DLLOAD) 


The DLLOAD keyword parameter determines whether capability for downline loading of 
user programs to a UTS 40 or UTS 400 terminal is to be configured. You must specify 
DLLOAD=YES whether you want to downline load your UTS programs by means of the 
IMS-provided transaction DLOAD or your own downline load action program. Downline 
loading requires continuous output capability; therefore, the configurator automatically 
generates CONTOUT=YES and UNSOL=YES when you include downline loading. 





Indicates that downline loading capability is not to be included in this 
configuration. 


DLLOAD=YES 
Specifies that downline loading capability is to be included. 
4.3.3.3. Allowing IMS/DMS Interface (DMS) 


The DMS keyword specifies IMS access to DMS data bases from user action programs 
or UNIQUE. 


DMS=YES 
Allows IMS access to DMS data bases. 





DMS 


Es: 


4.3.3.4. Using the Fast Load Feature (FASTLOAD) 


The FASTLOAD parameter is available in single-thread and multithread IMS. It allows 
IMS to create its own load file (LDPFILE) during online processing by copying the action 
program load modules from the load library. 


The first time a transaction calls on an action program, IMS copies the action program 
into the LDPFILE. After that, the action program is loaded from the LDPFILE. 


The fast load feature improves performance for applications with large action programs 
or extensive action program loading. It increases the size of online IMS by about 6000 
bytes. 


To use the fast load feature, you must place all action programs in a separate load 
library in unblocked format and assign this library at IMS start-up with the LFD-name 
LOAD. Do not place action programs in the system load library, $Y$LOD. You must 
allocate the LDPFILE as a system access technique (SAT) file and assign it at start-up. 
The LDPFILE should be 20 percent larger than the combined size of all action programs. 





FASTLOAD 
Specifies that the fast load feature is not included in this configuration. 
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FASTLOAD=YES 
Includes the fast load feature. 


NOTE: 


When using the fast load feature, you must place IMS action programs, including the 
online recovery program, ZS#ROL (single-thread) or ZU#ROL (multithread), in the LOAD 
action program library. See Figure D-9 for IMS action program module names. 


4.3.3.5. Allowing Updating of Files (FUPDATE) 


This keyword parameter specifies whether file updating is to be performed in this IMS 
configuration. If UNIQUE is to be used for updating files, you must specify 
FUPDATE=YES. If you specify FUPDATE=YES, IMS writes before-images to the audit 
file of all records of a file for which you specify LOCK=TR in the FILE section. 





Specifies that file updating may not be performed; update modules are not 
included in this configuration. 


FUPDATE=YES 
Specifies that file updating may be performed; necessary modules are included 
by the configurator. 


4.3.3.6. Specifying Interruption of LIST Output (INTLIST) 


The INTLIST keyword parameter increases throughput by automatically interrupting the 
generation of output from the UNIQUE LIST command so that another action may be 
scheduled at the terminal. It is most useful when many conditional LIST commands are 
to be performed and is used only with UNIQUE. 


lf INTLIST=YES or INTLIST=n is specified, LIST output is interrupted automatically with 
either the first screenful of output or when the number of file accesses exceeds 200 or 
your number specification (n). 


Even though the first 200 accesses (or the number of accesses you specify) do not 
generate a full screen of data, the results of the LIST command are output. If the 
terminal operator wants to cancel the current transaction or enter some_ other 
command, he may do so; if he wants to continue list generation, he need only transmit 
the MORE LIST command. He may repeat this process until he has satisfied his 
conditional LIST requirements or has entered a new transaction. 


INTLIST=n 
Specifies that LIST generation at the terminal is interrupted automatically on 
the first screenful of output or when this number of file accesses is reached, 
whichever occurs first. The maximum value of n is 32,000. 


INTLIS 
Indicates that the interrupted LIST is not to be performed and is the default 
assumption. 
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INTLIST=YES 
Specifies that list generation is to be interrupted automatically when the first 
screenful of output has been generated during execution of the LIST command, 
or when 200 file accesses have occurred, whichever takes place first. The 
results are output to the terminal. 





4.3.3.7. Clearing the Screen (MSGCLR) 


The MSGCLR keyword parameter specifies that IMS is to clear the screen before 
displaying a message. You can clear: 


= both protected and unprotected data. 
™ unprotected data only. 
=~ ~=only the lines required to display the message. 
MSGCLR=ALL 
Specifies that IMS is to clear the screen of both protected and unprotected 
data and return the cursor to the home position. 
MSGCLR 


Specifies that IMS is to clear only the lines required for the message. This is 
the default assumption. 








MSGCLR=UNPROT 
Specifies that IMS is to clear the screen of unprotected data and return the 
cursor to the home position. 


4.3.3.8. Positioning Messages on the Screen (MSGPOS) 


The MSGPOS keyword parameter specifies whether IMS status, error, and informational 
messages are to be displayed at the top or bottom of the screen. In either case, the 
message will occupy however many lines it needs to be displayed in its entirety. By 
using MSGPOS, you can prevent user data from being overwritten by IMS messages. 





Specifies that the message is to be displayed at the bottom of the screen. 
This is the default assumption. 


MSGPOS=TOP 
Specifies that the message is to be displayed at the top of the screen. 
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4.3.3.9. Providing Support for Console Transaction Processing (OPCOM) 


The OPCOM keyword parameter enables single-thread and multithread IMS users to 
enter terminal commands and transactions from the system console or master 
workstation. If you do not designate a master terminal (by including the MASTER=YES 
parameter in a TERMINAL section), IMS considers the system console to be your 
master terminal. In this case, support for console transaction processing is automatically 
included, and the configurator ignores the OPCOM parameter. 





Specifies that console support is not included in this IMS configuration and is 
the default assumption. 


OPCOM=YES 
Specifies that console transaction processing is supported. 


An IMS session may have a master workstation associated with it either by job control 
or by entering the IMS job from a workstation. If you configure the console as the 
master terminal or specify OPCOM=YES, you can enter unsolicited keyins from either 
the system console or the job’s master workstation. Switched messages, however, are 
always sent to the master workstation (if present) and are sent to the console only if 
the job has no master workstation or if the workstation is logged off. For more 
information on console transaction processing, refer to the IMS terminal users guide, 
UP-9208 (current version). 


4.3.3.10. Locking Records (RECLOCK) 


The RECLOCK keyword parameter provides the ability to carry record locks across 
actions in single-thread IMS. This feature is automatically available under multithread 
IMS; the RECLOCK parameter is not valid for multithread. 






Specifies no record locking across actions. 


When you use RECLOCK=NO with the LOCK=TR parameter in the FILE 
section, the N and O options on the lock-rollback indicator of the program 
information block are available; the R and H options are not available. Online 
recovery is performed. 


With the LOCK=UP parameter, there is no online recovery and no use of 
lock-rollback indicators for the file. 


RECLOCK=YES 
Allows record locking across actions in single-thread. Record locking across 
actions is always available in multithread. 


When you use RECLOCK=YES with the LOCK=TR parameter in the FILE 
section, all lock-rollback indicators are available and online recovery is 
performed for the file. 
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With the LOCK=UP parameter, there is no online recovery and no use of 
lock-rollback indicators for the file. 


4.3.3.11. Specifying Recovery Options (RECOVERY) 


The RECOVERY keyword parameter determines whether the images of updated records 
in DAM, ISAM, and MIRAM files are to be written online to the trace file for later use in 
— offline recovery and what images are to be written. 


RECOVERY=AFT 
Specifies that after-images of all updated records (those added or deleted, as 
well as those changed) are to be written to the trace file. 


RECOVERY=ALL 
Specifies that before- and after-images of all records being updated (changed, 
added, or deleted) are to be written to the trace file. 


RECOVERY=BEF 
Specifies that before-images of all records being updated (changed, added, or 
deleted) are to be written to the trace file. 





assumption. 


4.3.3.12. Disallowing Use of ZZRSD Terminal Command (RESEND) 


The RESEND keyword parameter provides or disallows the capability for your terminal 
operators to cause the most recent output response to be retransmitted by entering the 
ZZRSD command. Disallowing the use of the ZZRSD command (RESEND=NO) permits 
better utilization of existing ICAM buffers. Those that would normally be tied up holding 
output messages for retransmittal are instead released promptly to ICAM. If you forego 
the use of the ZZRSD command, furthermore, you may be able to generate ICAM with 
fewer buffers. The ZZRSD command has no role in continuous output. 


RESEND=NO 
Specifies that the capability of using the ZZRSD terminal command is not to be 
included in this configuration. !f the ZZRSD command is entered at a terminal, 
the response ‘NO MESSAGE IN QUEUE” is displayed. 





Specifies that the capability of using the ZZRSD terminal command is to be 
included in this configuration and is the default assumption. Does not increase 
main storage requirements. 
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4.3.3.13. Specifying Number of Resident Screen Formats (RESFMT) 


The RESFMT keyword parameter specifies the maximum number of screen formats that 
will remain resident between successive calls to IMS for screen format services (SFS). 


RESFMT=n 
Specifies the maximum number of screen formats that will remain resident 
between SFS calls. The default assumption is 1 for single-thread IMS and 3 for 
multithread IMS. The maximum value you can specify is 255. The RESFMT 
parameter is valid only when SFS=n is specified. 


4.3.3.14. Providing Support for Screen Formatting (SFS) 


The SFS parameter allows your action programs to call on IMS to construct screen 
formats via the OS/3 screen format coordinator. Screen format services require a 
control system generated in CDM mode or mixed mode. However, you can use screen 
format services with an IMS system configured in either CDM or DTF mode. With the 
SFS parameter, you designate the number of terminals that can use screen formatting 
simultaneously. 


You must allow one slot for each terminal that: 
= =~§= is waiting for formatted screen output. 


m has received formatted screen output and is waiting for the operator to enter input 
(if the screen contains input fields). 


m has entered input and is waiting for either an error screen or verification that the 
input was accepted. 


SFS=n 
Allows action programs to use screen format services. The n specifies the 
maximum number of terminals that will use screen formatting simultaneously. 
Do not specify more than 255. 





Specifies that screen format services are not included in this configuration. 


4.3.3.15. Specifying an Edited Directory for Snapshot Dumps (SNAPED) 


The SNAPED keyword parameter specifies whether an edited directory of key IMS 
information is to be printed with snapshot dumps. This option is available only for 
multithread IMS and increases the size of the online load module by 3600 bytes. In 
single-thread IMS, termination snapshot dumps routinely include an edited directory; 
CALL SNAP dumps do not include an edited directory. 
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Specifies that snapshot dumps are not to include an edited directory. 


SNAPED=YES 
Specifies that an edited directory is to be printed preceding snapshot dumps. 


4.3.3.16. Recording Statistical Information at Shutdown (STATS) 


The STATS keyword parameter provides for writing of statistical information in the 
statistics file (STATFIL) at IMS shutdown. When you specify STATS=YES, IMS 
automatically schedules the ZSTAT transaction at shutdown time. ZSTAT records data 
on the activity of files, programs, transactions, and terminals during a session. 





Specifies that data is not written into the statistics file at shutdown. It is the 
default assumption. 


STATS=YES 
Specifies that data is written into the statistical file at shutdown. 


4.3.3.17. Including Support for User-Written Subprograms (SUBPROG) 


The SUBPROG keyword parameter specifies that resident user-written subprograms may 
be called by COBOL or BAL action programs. To use this feature, you must also 
indicate the name of each subprogram on the program-name parameter of a PROGRAM 
section and specify SUBPROG=YES in the same section. 


SUBPROG=NO: 
Specifies that user-written subprograms are not to be called by COBOL or BAL 
action programs. 


SUBPROG=YES 
Specifies that COBOL or BAL action programs may call resident user-written 
subprograms. 


4.3.3.18. Generating a Partition for Terminal Output Messages (TOMFILE) 


The TOMFILE keyword parameter specifies that IMS is to generate a partition, called the 
TOMEFILE, in the AUDCOMF file (single-thread) or the CONDATA file (multithread) to hold 
terminal output messages for use by your terminal operators during online recovery and 
at cold or warm start-up. You must specify TOMFILE=YES to use the warm start 
feature. 


During online: operations, IMS writes to the TOMFILE partition the output message 
generated for each terminal at rollback points and at transaction termination, retaining 
only one message per terminal. The terminal operator can display the most recent 
message by entering the transaction code DLMSG. These output messages are also 
recorded in the trace file for use in offline recovery if you specify the TOMTRCE 
configuration parameter. 
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TOMFIL 


Specifies that a TOMFILE partition is not to be generated and is the default 
assumption. 





TOMFILE=YES 
Specifies that IMS is to generate a TOMFILE partition in the AUDCONF or 
CONDATA file at configuration time and to write to this partition, during online 
operations, the output message generated for each terminal at each rollback 
point and at transaction termination. 


4.3.3.19. Specifying Terminal Output Message Tracing (TOMTRCE) 


When you include the TOMFILE keyword parameter, online IMS writes terminal output 
messages to the TOMFILE partition of the AUDCONF or CONDATA file for use during 
online recovery. When you also specify TOMTRCE=YES, these messages are also 
written to the trace file so that they are available for reconstructing the TOMFILE 
partition, using the ZC#TRC offline recovery program. If output messages are to be 
traced, the configurator examines OUTSIZE specifications as well as data record sizes in 
computing the block size of the trace file. 


TOMTRCE= 
Specifies that output messages are not to be traced and is the default 
assumption. 





TOMTRCE=YES 
Specifies that terminal output messages written to the TOMFILE partition are 
also written to the trace file. 


4.3.3.20. Configuring UNIQUE Capability (UNIQUE) 


You use the UNIQUE keyword parameter to specify whether or not the uniform inquiry 
update element (UNIQUE) is to be used in this IMS configuration and whether the 
UNIQUE command interpreter action program (ZU#CIN) is to be resident. Refer to the 
MAXCONT keyword parameter of the GENERAL section. 


UNIQUE=NO 
Specifies that the UNIQUE capability is not to be included in this configuration. 


UNIQUE=RES or 
Specifies that the UNIQUE command interpreter action program (ZU#CIN) is 
resident (that is, permanently loaded at IMS start-up time). This specification 
adds approximately 1700 bytes to your main storage requirements. 





UNIQUE=TRAN 
Specifies that all UNIQUE action programs are to be loaded as required. 


lf omitted, IMS assumes UNIQUE= YES. 
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4.3.3.21. Providing Capability for Unsolicited Output (UNSOL) 


The UNSOL keyword parameter specifies whether the capability for unsolicited output is 
to be included in your IMS configuration. 


Unsolicited output involves generating multiple messages or sending messages to 
terminals other than the originating terminal. Unsolicited output capability is 
automatically included if continuous output is configured by means of the CONTOUT 
keyword parameter or if downline loading is configured with the DLLOAD parameter. 


UNSOL= YES (or CONTOUT=YES) must be specified if: 
m a user-written action program issues the SEND function; 


m the ZZTST master terminal command is used to test whether a network terminal is 
able to receive output; or 


ws the SWTCH transaction is used for terminal-to-terminal communication. 


In order to use unsolicited output, you must generate an ICAM module that supports 
unsolicited output. See 2.3.2.1 and 2.3.2.2 for specific requirements. 


UNSOL 


Specifies that no capability for unsolicited output is to be included in this 
configuration. When specified along with CONTOUT=YES or DLLOAD=YES, 
UNSOL=NO is ignored; no diagnostic message is issued. 





UNSOL=YES 
Specifies that unsolicited output is to be included in this configuration. This is 
the default assumption when you specify CONTOUT=YES or DLLOAD=YES. 
4.3.4. Specifying Time-out Values — the TIMEOUTS Section 


The TIMEOUTS section stipulates the various time-out values to be used in this IMS 
configuration. The TIMEOUTS section is optional and nonrepeatable. 


Format: 


TIMEOUTS | ACTION=/ n 
B (multithread) 
68 (single-thread) 


Pes 








Example: 


TIMEOUTS ACTION=180 STATUS=30 
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4.3.4.1. Specifying Action Program Elapsed Time (ACTION) 


The ACTION keyword parameter specifies the maximum number of seconds that an 
action program is allowed to have control before timing out. This specification has a 
different meaning in a single-thread than in a multithread IMS system. In single-thread, it 
is the total execution time for an action program; in multithread, it is the amount of time 
an action program may retain control between calls to IMS. 


ACTION=n 
Specifies the action time-out value in seconds. 


1. Single-thread 


In a single-thread system, n is the maximum number of seconds that an 
action program is allowed to execute. Maximum time-out value is 900 
seconds. The minimum and default value is 180 seconds. 


IMS uses a different time-out value to detect a program loop. You do not 
specify this value — it is always 60 seconds. When an action program fails 
to issue a function call within 60 seconds after getting control, the 
program is canceled. 


IMS uses a third time-out value at shutdown time. Ongoing transactions 
are allowed to continue processing for 180 seconds after the ZZSHD 
master terminal command is issued. You can override this value by 
specifying the shutdown time-out on the ZZSHD terminal command. 


2. Multithread 


In a multithread system, n is the time-out value IMS uses to detect a 
program loop. When an action program fails to issue a function call within 
n seconds after getting control, the program is canceled. The minimum 
value (which is also the default) is 30 seconds. For efficiency in a 
multithread system, you should specify a relatively low time-out value. 


This specification also determines the shutdown time-out value - that is, 
the length of time ongoing transactions are allowed to continue processing 
after the ZZSHD master terminal command is issued. Shutdown time-out 
is five times the action time-out value. You can override this value by 
specifying the shutdown time-out on the ZZSHD terminal command. 


In multithread IMS, there is no maximum time-out value for overall 
execution of an action program. 


NOTE: 
Action time-out is based on elapsed time, not processor time, from the point at which 


the program receives control to the point at which it returns control to application 
management (e.g., |/O requests and termination). 
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4.3.4.2. Specifying Elapsed Time between Input and Status (STATUS) 


Online IMS transmits automatic status messages to notify a terminal operator of the 
status of the last input message. The STATUS keyword parameter determines how 
many seconds elapse after an input message has been received by IMS before the 
status of the message is sent and the interval at which the message is resent. 
Automatic status messages are not sent to a terminal executing an output-for-input 
queueing or continuous output action. This keyword is valid only for a multithread IMS 
system. 


STATUS=n 
Specifies the status message interval in seconds (minimum 15 seconds). The 
default value is 15 seconds. 


NOTE: 


The status message interval is based on elapsed time, not processor time. 


4.3.5. Describing Each User Data File — the FILE Section 


You must code a FILE section to describe each of the ISAM, MIRAM, DAM, or SAM 
data files your action programs access - whether these are accessed directly or 
indirectly via the medium of the defined file. You therefore provide a FILE section for: 


m™ each user data file named via a FILES keyword parameter in an ACTION section; 
and 


= each data file that contributes a primary or supplementary part to the defined 
records of a defined file or subfile specified by a DFILE keyword parameter. 


Do not code a file section for DMS data base files. 


A maximum of 240 files may be defined in multithread IMS, but only 123 in 
single-thread. 


Format: 


FILE filename 


FILETYPE=/DAMR 
DMRAM 
ISAM 
SAMD 
SAMT 
TMRAM 


ae 
YES 


eee 
YES continued 
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tres 
| 


ae 





} 


OUTPUT= { 


[ 
ae 
["" 


TRACE= 





valid DTF or RIB keyword parameters for the 
specified file 


Example 1 (DTF mode): 


FILE CUSTFIL FILETYPE=ISAM LOCK=TR 
IOROUT=ADDRTR KEYLEN=5 RECFORM=FIXBLK RECSIZE=80@ IOREG=(8) 
PCYLOFL=10 KEYLOC=@ WORK1=CUSTFIL 
IOAREA=CUSTFIL TYPEFLE=RANSEQ BLKSIZE=1622 
FILE DUEIN FILETYPE=ISAM LOCK=TR CAFILE=YES CUPDATE=YES 
IOROUT=ADDRTR KEYLEN=17 RECFORM=FIXBLK RECSIZE=22 IOREG=(8) 
PCYLOFL=1@ KEYLOC=1 WORK1=DUEIN 
IOAREA1=DUEIN BLKSIZE=758 TYPEFLE=RANSEQ 
FILE SAMDISK FILETYPE=SAMD 
BLKSIZE=1024 IOAREA1=SAMDISK TYPEFLE=OUTPUT WORKA=YES 
FILE VENDOR FILETYPE=DAMR LOCK=TR 
BLKSIZE=256 KEYLEN=@ READID=YES WRITEID=YES 


Example 2 (CDM mode): 


FILE CUSTFIL FILETYPE=DMRAM INDAREA=CUSTFIL INDSIZE=256 KEYARG=CUSTFIL 
KEY 1=(8,1) 
FILE EMPLOY FILETYPE=TMRAM 


4.3.5.1. Naming the User Data File (filename) 


The filename positional parameter is always required; it provides the logical name of a 
user data file to be accessed. 


If the user data file contributes to a defined file or subfile, filename must be the same 
as the file-name specified in the FD entry in the data division of your data definition. It 
is not the same as the filename response to the DFILE keyword parameter in the 
ACTION section. 
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On the other hand, if the user data file does not contribute to a defined file but is 
accessed directly by your action program, then filename must be the same as one of 
the file names specified via the FILES keyword parameter in an ACTION section and 
must be the logical name by which your action program refers to the file. 


filename 
Specifies a 1- to 7-character alphanumeric name whose first character Is 
alphabetic. 
NOTE: 


Each file name must be unique. Also, you can’t have two file names that are the same 
except for one additional letter at the end of one of them. For example, if you use INV 
and INVH for file names, you get an assembly error in the configuration. 


4.3.5.2. Identifying the Type of Data File (FILETYPE) 


With the FILETYPE keyword parameter, which is always required, you must specify the 
type of user data file this section is describing. 


FILETYPE=DAMR 
Specifies a DAM file, organized by relative record address. 


FILETYPE=DMRAM 
Specifies a MIRAM file (or an IRAM file accessed via MIRAM). IMS supports 
multikey MIRAM files, but only the primary key may be used to update the file. 
(See Table 4-7.) Any key may be used to access the file. 


FILETYPE=ISAM 
Specifies an ISAM file. 


FILETYPE=SAMD 
Specifies a SAM file on disk. 


FILETYPE=SAMT 
Specifies a magnetic tape SAM file in a DTF system. 


FILETYPE=TMRAM 
Specifies a sequential magnetic tape file in a CDM system. 


4.3.5.3. Specifying and Updating Common Storage Area Files (CAFILE and 
CUPDATE) 


The common storage area file is a main storage resident, variable-block or fixed-block 
ISAM file in DTF mode or MIRAM file in CDM mode. It is loaded into main storage 
during the IMS start-up procedure and can be used to store vital information that is 
frequently accessed. During online processing, you may issue the GET, GETUP, and PUT 
function calls to a resident common area file. During shutdown, the disk file is updated 
using the data in main storage. 
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CAF ILE=86 
Specifies that this is not a common area file. 


CAFILE=YES 


Specifies that this ISAM or MIRAM file is loaded into main storage common 
area at start-up. 


To update common area files on disk, the CUPDATE parameter is used, together with 
the CAFILE parameter. 





Specifies no disk updates for this common area file after each access to the 
resident file. When both the CAFILE=YES and CUPDATE=NO parameters are 
configured, the common storage area file is written back to the disk once, at 
shutdown. 
CUPDATE=YES 
Specifies that disk updates are made for the common area file after each 
access to the resident file. 
4.3.5.4. Allowing Physical Deletion of MIRAM File Records (DELETP) 


The DELETP parameter determines whether records in a MIRAM file can be physically 
deleted. This option is not available for IRAM files defined as MIRAM files. 


DELETP=NO 
Specifies that records cannot be physically deleted. (They can still be logically 
deleted.) 


DELETP=YES 
Specifies that records can be physically deleted. 


The default values are: 
w YES, for a multikey file; and 


= NO, for a single key file. 


4.3.5.5. Selecting Type of File Record Lock (LOCK) 


The LOCK parameter determines the type of record lock that IMS imposes on DAM, 
ISAM, and MIRAM files during updating transactions. 


When you select lock for transaction (LOCK=TR) or omit this parameter: 
= IMS locks records being updated until the end of the action. 
m= = In single-thread IMS, when you specify RECLOCK=YES in the OPTIONS section, 


you can use the R and H lock rollback indicators in the program information block 
to hold record Jocks across actions. 
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= Updates are always audited (before-image recorded in the audit file) and are rolled 
back if the transaction abnormally terminates. 


When you select lock for update (LOCK =UP): 

= IMS locks records only for the duration of an update. 

= = {f an update is incomplete at the end of the action, IMS holds the record lock into 
the next action (except in single-thread IMS with RECLOCK=NO). You can release 


the lock with an R, N, or O lock rollback indicator or UNLOCK function call. 


m= Updates are not audited and are not rolled back if the transaction terminates 
abnormally. 


The type of record lock does not affect tracing of updates (using the trace file) for 
offline recovery. All updated records are traced (if RECOVERY is specified in the 
OPTIONS section), whether or not locking is included. 





Specifies lock for transaction. 


LOCK=UP 
Specifies lock for update. This specification makes the file nonauditable and its 
blocksize is not considered when audit file blocksize is determined. 


4.3.5.6. Allowing Output Processing for a Dedicated Sequential File (OUTPUT) 


A dedicated sequential MIRAM file may be used for input or output processing, but not 
both. With the OUTPUT keyword parameter, you tell the configuration whether this is 
an input or output file. Sequential MIRAM files are not audited or traced, regardless of 
the OUTPUT specification. This parameter does not apply to any other file type. 





ifies that this sequential MIRAM file is used for input processing. 


OUTPUT=YES 
Specifies that this sequential MIRAM file is used for output processing. 


4.3.5.7. Specifying the Primary Key of a Multikey File (PKEY) 
The PKEY parameter specifies the primary key of a multikey MIRAM file. 


PKEY=n 
Specifies which of the keys specified by KEYn parameters is the primary key 
of the file. The default value is 1. 


If you specify a value for n greater than any specified in the data management keyword 
KEYn, IMS creates dummy keys to make up the difference. If, for example, you specify 
PKEY=5 with only KEY1 and KEY2, IMS creates keys 3, 4, and 5. You should 
reconfigure IMS with correct KEYn and PKEY specifications. Otherwise, you will get an 
error when you attempt to access the file by its primary key. 
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4.3.5.8. Suppressing File Tracing (TRACE) 


If file recovery is configured (through the RECOVERY parameter in the OPTIONS 
section), you can select which files are to be traced by coding the TRACE parameter. 
Tracing only essential files improves processing performance. TRACE=NO should be 


specified for files that are not to be updated. Tracing is performed for DAM, ISAM, and 
MIRAM files only. 


TRACE=NO 
Specifies that this file is not to be traced and therefore its characteristics, e.g., 


BLKSIZE or RECSIZE, are not used in determining the blocksize of the trace file 
(TRCFILE). 





Specifies that this file is to be traced. This is the default option if file recovery 
is configured. 


4.3.5.9. Providing DTF or RIB Keywords to the Configurator 


The configurator generates a data management DTF or RIB macroinstruction for each of 
your data files. You provide the information the configurator needs to build the DTF or 
RIB by coding data management keyword parameters in the FILE section after the other 
FILE section parameters. 


Tables 4-2 through 4-8 list the DTF and RIB keywords that you may include in the FILE 
section for each of the file access methods IMS supports. You use DTF keywords for 
an IMS system in DTF mode; RIB keywords for an IMS system in CDM mode. For most 
parameters, the configurator generates a default value or uses the default value supplied 
by data management. You should code these parameters only if you require a different 
value. Keywords shown in the tables without default values are optional. 


For detailed information on the uses and meanings of the DTF keyword parameters, 
refer to the data management user guide, UP-8068 (current version); for RIB keywords, 
see the consolidated data management concepts and facilities, UP-8825 (current 
version) and consolidated data management macroinstructions user guide/programmer 
reference, UP-8826 (current version). The configurator accepts only the data 
management keywords and values listed in the tables and only in the forms shown in 
the table. The shortened alternative forms and additional values documented in the data 
management guides may not be used in IMS. 
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Table 4-2. DTF Configurator Keywords for an ISAM File 


Configurator Data Management 


Generates Default | Generates Default Remarks 


Keyword 


ACCESS= 


If omitted, IMS issues a _ warning 
diagnostic; this may be ignored. 


lf included, filename must match the 
filename positional parameter in this 
FILE section. 


If included, filename must match the 
filename positional parameter in this 
FILE section. 


Specify IOROUT=RETRVE for read-only 
files. If omitted, IMS issues a warning 
diagnostic; this may be ignored. 


If included, filename must match the 
filename positional parameter in this 
FILE section. 





KEYLOC=n If omitted, this keyword takes the data 
management effective value. 


—_) 
ce te 


oa eee Specify TYPEFLE=RANSEO for UNIQUE 


RANSEQ and random processing. 


eee Specify UPDATE=NO for read-only files. 





VERIFY=YES If omitted, this keyword takes the data 
management effective value. 


WORKS=NO If omitted, this keyword takes the data 
management effective value. 


WORK1=filename lf included, filename must match the 
filename positional parameter in this 
FILE section. 
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Table 4-3. DTF Configurator Keywords for a DAM File 


ACCESS= 


BLKSIZE= If omitted, IMS issues a_ warning 
diagnostic; this may be ignored. 


IOAREA1=filename If included, filename must match the 
filename positional parameter in this 
FILE section. 


READID=YES If omitted, IMS issues a warning 
diagnostic; this may be ignored. 


RECFORM= { 


RELATIVE=R 


SEEKADR=filename If included, filename must match the 
filename positional parameter in this 
FILE section. 


TYPEFLE= 


VERIFY=YES If omitted, this keyword takes the data 
management effective value. 


WRITEID=YES If omitted, IMS issues a _ warning 
diagnostic; this may be ignored. 
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Table 4-4. DTF Configurator Keywords for a SAM Disk File 


Configurator Data Management 
Generates Default {| Generates Default 










Remarks 


oe lf omitted, IMS issues a warning 






ACCESS= ( EXC 


BLKSIZE= 


EOFADDR=filename 


IOAREA1=fitename 





diagnostic; this may be ignored. 


Used for input files only. 





If included, filename must match the 
filename positional parameter in this 
FILE section. 


Used for input files only. 
Used for input files only. 


oe aa 

a rs 
If omitted, this keyword takes the data 
management effective value. 


Used for output files only. 









IOREG=(8) 















OPTION=YES 


RECFORM= 


TYPEFLE= { Fi | 
OUTPUT 


VERIFY=YES 
WORKA=YES 
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Table 4-5. DTF Configurator Keywords for a SAM Magnetic Tape File 


Keyword Configurator Data Management Remarks 
Y Generates Default | Generates Default 
pean omitted, IMS issues warning 
digi: this may be ace 
CLRW= = omitted, IMS issues a warning 
igen this may be ignored. 




















RWD 








If included, filename must match the 
filename positional parameter in this 
FILE section. 








Used for input files only. 








OPTION=YES 






RECON 
{eae | 


TPMARK=NO If omitted, this keyword takes the data 
management effective value. 
EEE | x 
OUTPUT 
eee ae ei bu au ia one 











f 
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Table 4-6. DTF Configurator Keywords for a MIRAM File (Part 1 of 2) 


K d Configurator Data Management 
ial Sak Generates Default Generates Default 


INDAREA = filename 


SADD is not supported for 
multithread IMS. If specified for 
single-thread, IMS cannot be 
responsible for the integrity of the 
file. SADD should be specified 
only if recovery is not configured 
and LOCK=UP is specified in the 
FILE section. 


Configurator generates default 
when PROC=KEY. Do not specify 
for unkeyed files. 


Must be consistent with load time 
value. Configurator genertes 
default when PROC=KEY. Do not 
specify for unkeyed files. 


KEY ARG = filename 


KEYn= 


(Ges i 


Configurator generates default 
when PROC=KEY. Do not specify 
for unkeyed files. 


Must be consistent with load time 
values. Configurator generates 
defaults when PROC=KEY. For a 
multikey file, KEYn may be any of 
the keys. IMS accesses the file 
using the KEYn specification. 


Specify MODE=RAN for random 
and nondedicated sequential 
processing. If MODE=SEQ, action 
programs may issue only GET or 
PUT functions, depending on 
OUTPUT keyword — specification 
(4.3.5.5). 
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@ Table 4-6. DTF Configurator Keywords for a MIRAM File (Part 2 of 2) 


K d Configurator Data Management 
eywor Generates Default Generates Default 


NWAIT = YES 


Specify PROC=KEY keyed 
files. 


Specify RCB=NO for an IRAM 


RETR=MOD 
SEEK ADR= filename 


VERIFY = YES If omitted, this keyword takes the 
data management effective value. 
VMNT = ONE dedicated sequential 
J santa only. 
WORK = YES 
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Table 4-7. RIB Configurator Keywords for a MIRAM File (Part 1 of 2) 





xX SADD is’ not’ supported for 
multithread IMS. If specified for 
single-thread, IMS cannot be 
responsible for the integrity of the 
file. SADD should be specified 
only if recovery is not configured 
and LOCK=UP is specified in the 
FILE section. 


ce Se 

INDAREA = filename x Configurator generates default 
when PROC=KEY. Do not specify 
for unkeyed files. 

INDSIZE { n xX Must be consistent with load time 
value. Configurator generates 
default when PROC=KEY. Do not 
specify for unkeyed files. 


KEYARG =filename Configurator generates default 
when PROC =KEY. Do not specify 
for unkeyed files. 





KEYn= Must be consistent with load time 
size,loc i: : ‘| { values. Configurator generates 
DUP CHG defaults when PROC=KEY. For a 

multikey file, KEYn may be any of 


the keys. IMS accesses the file 
using the KEYn specification. 


aed RAN Specify MODE=RAN for random 
and nondedicated sequential 
processing. If MODE=SEQ, action 
programs may issue only GET or 
PUT functions, depending on 
OUTPUT keyword = specification 
(4.3.5.5). 
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Table 4-7. RIB Configurator Keywords for a MIRAM File (Part 2 of 2) 


Keyword Configurator Data Management 
" Generates Default Generates Default 















Specify PROC=KEY for keyed 









en NO } Specify RCB=NO for an IRAM 


YES 








RECFORM = fFIXUNB 
Hobe 


RECSIZE 4 n 


RETR=MOD 
SEEK ADR =filename 


VERIFY 





Bec el 


VMNT=ONE 


WORK = YES 


Used dedicated sequential 
eestor only. 
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Configurator Data Management 
Generates Default | Generates Default 







RECFORM= FIXUNB } 
VARUNB 


TYPEFLE= 





OUTPUT 






4.3.6. Describing Terminals — the TERMINAL Section 





4-82 








The TERMINAL section defines the master terminal and other attributes of terminals in 
the IMS network. All terminals listed must be defined in the ICAM network definition, 


but you need n 


Format: 


ot include a TERMINAL section for every terminal. 


TERMINAL terminal - id 


[ 


a 


[ 
| 






| 
=) 


a ACTION H 


= 7 








URGENT= 
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Example: 


TERMINAL T6001 MASTER=YES URGENT=YES 
TERMINAL TO@3 URGENT=YES 

TERMINAL T604 IMSREADY=NO UNSOL=ACTION 
TERMINAL T0065 

TERMINAL T006 


NOTE: 


When you start up IMS with a global ICAM network, IMS reserves terminal slots for all 
terminals that you identify in TERMINAL sections with a terminal-id, whether or not you 
include any optional parameters. (See TERMS parameter, 4.3.1 7.) 


4.3.6.1. Identifying the Terminal (terminal-id) 
terminal -id 

Is the 1- to 4-character alphanumeric identification you assigned to this 
terminal in your ICAM network definition and must always be specified. Its first 
character must be alphabetic. (See Section 2 for ICAM considerations.) 

4.3.6.2. Suppressing the IMS READY Message (IMSREADY) 

The IMSREADY keyword parameter may be used to suppress output of the IMS READY 

message to selected terminals at IMS start-up time. This parameter does not apply to 


dynamic terminals in a global network. 


IMSREADY=NO 
Specifies that the IMS READY message is not to be sent to this terminal. 


IMSREADY=¥ES 
Indicates that this terminal is to receive the IMS READY message and is the 
default assumption. 
You should not specify IMSREADY =NO for local workstations that are: 


@ ~=used in a dedicated ICAM environment; or 


= = statically assigned in a global ICAM environment. 


4.3.6.3. Defining the Master Terminal (MASTER) 


The MASTER keyword parameter identifies a terminal in the ICAM network as the 
master terminal. The system console can serve as the master terminal, in which case 
you omit this parameter. 
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Only one terminal can be designated as a master terminal in a configuration. If the 
master terminal becomes inoperative, you can use the ZZMCH terminal command to 
designate another terminal as the master terminal during the online IMS session. 





Specifies that this is not the master terminal and is the default assumption. 


MASTER=YES 
Specifies that this is the master terminal. lf MASTER=YES is not specified for 
any regular terminal, the system console is the master terminal. 


For a complete description of the commands and transactions you can enter at the 
master terminal, refer to the IMS terminal users guide, UP-9208 (current version). 


4.3.6.4. Specifying Message Notification after Each Action (UNSOL) 


Normally, switched unsolicited output messages are queued at a terminal until the 
transaction in progress is completed; the operator is then notified by means of the 
unsolicited output indicator. You can use the UNSOL keyword parameter to specify that 
the operator be notified of such messages at the end of each action instead. 


UNSOL=ACTION 
Specifies that the terminal operator is to be notified of switched unsolicited 
output messages at the end of each action. 





Specifies that the terminal operator is to be notified only at completion of a 
transaction and is the default assumption. 


If UNSOL=ACTION is specified, the terminal operator (once notified of queued 
messages via the unsolicited output indicator) can accept the queued output or transmit 
an input messages. If he transmits another input message, the input is processed and 
the switched messages remain queued. 


4.3.6.5. Specifying Terminal Message Priority (URGENT) 


The URGENT keyword parameter determines whether all input messages from this 
terminal are designated as urgent in priority. This parameter applies to multithread IMS 
only. 


URGENT=NQ 
Specifies that messages from this terminal have normal priority and is the 
default assumption. 


URGENT=YES 
Specifies that all messages from this terminal are urgent. 
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4.3.7. Specifying Transaction Codes -— the TRANSACT Section 


The TRANSACT section supplies information about your transactions to the 
configurator. This section must be specified for each transaction code. 


Format: 


TRANSACT trans-code 
[ACTION=program-name ] 
[LOCAP=Locap-name] 





Example: 


TRANSACT CHG ACTION=CHANGE 
TRANSACT DUMP URGENT=YES 
TRANSACT SHOW 

TRANSACT TOTAL 

TRANSACT F#01 ACTION=UPDATE 
TRANSACT ERRMSG UNDEF=YES 


The DUMP, SHOW, TOTAL and ERRMSG transactions are started by action 
programs having the same names. All transaction codes except DUMP have routine 
priority. Transaction F#01 is initiated by function key F1. The ERRMSG transaction 
handles undefined transaction codes. 


4.3.7.1. Naming the Transaction (trans-code) 


The trans-code positional parameter assigns a transaction code to the transaction and 
must be the first parameter specified in the TRANSACT section. This transaction code 
is keyed in by the terminal operator to initiate the transaction. A transaction may also 
be initiated at the terminal by a function key (F1 through F33), in which case the 
trans-code parameter specifies the function key. See Appendix A for reserved (IMS 
internal) transaction codes. 


trans-code 
Names the transaction and consists of one to eight alphanumeric characters 
(multithread IMS) or one to five alphanumeric characters (single-thread). The 
length of the transaction code in multithread IMS is limited to the TRANLEN 


parameter specification in the GENERAL section. If the transaction code is 
longer than the maximum allowed, IMS truncates the code. 
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The first character of the transaction code must be alphabetic. Duplicate transaction 
codes are not allowed. If the transaction is to be initiated by a function key, the 
trans-code parameter has the format: 


F#nn 
where: 


nn 
Is the number of the function key (01 through 33). 


lf KATAKANA=VYES is specified in the NETWORK section, the transaction code can 
consist of Katakana characters. 


4.3.7.2. Assigning the First Action Program for This Transaction (ACTION) 


The ACTION keyword parameter identifies the first action program to be scheduled for 
this transaction. If this is a remote transaction, omit the ACTION parameter. 


ACTION=progr am-name 
Specifies a 1- to 6-alphanumeric-character action program name; the first 
character must be alphabetic. This name must be the same as_ the 
program-name specified in the corresponding ACTION section. 


If omitted for a local transaction, the first action program to be scheduled is 
assumed to have the same name as the transaction; that is, ACTION=trans-code is 
assumed. 


4.3.7.3. Specifying a Remote System Where the Transaction Is Processed 
(LOCAP) 


The LOCAP keyword parameter specifies that this is a remote transaction and identifies 
the remote system where the transaction is processed. You use this parameter for 
directory routing of transactions in a distributed data processing environment. It is 
available only in multithread IMS. 


LOCAP=locap-name 
Specifies the local application that processes the transaction at a remote 
system. The locap-name must be a valid name specified in a CUP keyword 
parameter of the NETWORK section for the remote IMS system configuration. 
It cannot be a name specified in the CUP keyword parameter of this 
configuration. If LOCAP is specified, you should omit the ACTION parameter. 
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4.3.7.4. Indicating a Default Transaction Code (UNDEF) 


The UNDEF keyword parameter specifies whether this transaction is to be used as the 
default transaction for this configuration. When a terminal operator enters a transaction 
code that has not been defined to IMS, IMS calls upon this transaction to process it, 
rather then sending an “‘invalid transaction code’’ message to the originating terminal. 


UNDEF =e 
Specifies this transaction is not the default for undefined transaction codes. 





UNDEF=YES 


Specifies this transaction is to be used by default to handle undefined 
transaction codes. 


IMS allows you to specify no more than one transaction as undefined. If more than one 
TRANSACT section specifies UNDEF=YES, only the first is accepted and all others are 
ignored. 


4.3.7.5. Specifying Priority of the Transaction (URGENT) 
The URGENT keyword parameter determines whether all transactions with this 


transaction code are to be given urgent priority; it is not available for single-thread IMS 
systems. 





URGENT=N80. 
Indicates that transactions with this code are not necessarily urgent and is the 
default assumption. 


URGENT=YES 
Indicates that all transactions with this code are urgent. 
4.3.8. Describing the Options for Each Action — the ACTION Section 


In one or more ACTION sections, you describe each of the actions in your application 
to the configurator. This section must be coded once for each action. 


Format: 
ACTION program-name 
leas ’ } 
YES 
Kees a} 


[CDASIZE=n] 
[DDRECORD=record-name] 


[DFILE=f ilename] 





continued 
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EDIT={c 
FCCDICE 
NONE 
tablename 
ae {ye } 
i. ee 


aaa } 
eae 


[MAXSIZE=n] 


Pil 
ie 


[SHRDSIZE=n] 


pase | 
en 


[WORKSIZE=n] 








Example: 


ACTION.UPDATE MAXSIZE=100@ OUTSIZE=204 

EDIT=% FILES=MAINFIL,PAYROLL,ACCTREC,ACCTPAY 
FILES=STATS, EMPLOYS 

ACTION DUMP OUTSIZE=84 MAXSIZE=250 FILES=ALL 
ACTION LIST MAXSIZE=2000 OUTSIZE=1156 FILES=MAINFIL 





Three actions are described: UPDATE, DUMP, and LIST. You can split multiple 


responses to a parameter between cards by repeating the keyword, as shown on 
the second and third lines of coding. 


4.3.8.1. Naming the First Action Program for This Action (program-name) 


program-name 
Is the name of the first action program to be executed for this action and must 
be specified. The name consists of one to six alphanumeric characters; the 
first character must be alphabetic. The same program-name must not be 


specified for more than one action. This name must be the same as a 
program-name in a PROGRAM section. 


4.3.8.2. Specifying Whether All Action Programs Are Reentrant (ALLRNT) 


The ALLRNT keyword parameter specifies whether all programs for this action are 
reentrant; it is available only for a multithread IMS system. 
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ALLRNT 
Specifies that not all programs are reentrant. 





ALLRNT=YES 
Specifies that all programs are reentrant. 


NOTE: 


IMS can use main storage more effectively if all action programs for an action are 
defined as reentrant. 


4.3.8.3. Limiting Waiting Time for an Action (BYPASS) 


The BYPASS keyword parameter specifies the maximum number of times this action 
may be bypassed for initiation before being unconditionally initiated. It is available only 
for a multithread IMS system. 


BYPASS=n 
Specifies the bypass limit. If BYPASS=O is specified, the action is never 
bypassed. 


If omitted, a bypass limit of 5 is assumed. 


4.3.8.4. Specifying Size of the Continuity Data Area (CDASIZE) 


The CDASIZE keyword parameter specifies the size of the continuity data area for this 
action. If the action accesses a DAM file and uses a CDA as a record area, the size 
must be large enough to accommodate the DAM file record (which is a 256-byte 
multiple). 


If this action accesses a DMS data base and you include the USING ACTIVATION 
RECORD clause in the schema section of your action program, you must allocate a 
continuity data area or work area large enough to contain the DMCA or subschema 
records (or both). Your program determines where these records are placed. Refer to 
the IMS/DMS interface user guide, UP-8748 (current version). 


CDASIZE=n 
Specifies the size, in bytes, of the continuity data area. This value must not 
exceed the specification for the MAXCONT parameter in the GENERAL section, 
nor can it exceed the track size for the type of disk being used. 


lf omitted and you specify UNIQUE=YES or RES in the OPTIONS section, 
CDASIZE=1792 is assumed. If both parameters are omitted, no continuity data 
area is allocated. 
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4.3.8.5. Naming the Data Definition Record (DDRECORD) 


The DDRECORD keyword parameter names the data definition record associated with 
the defined file for this action. When the action is scheduled, IMS places this name in 
the DATA-DEF-REC-NAME field of the program information block (PIB), unless a record 
name has been left in that field by the preceding action. 


The record name specified with this keyword is the same as the defined-file-name in the 
defined file definition - it is not the defined-record-name specified with the DEFINED 
RECORD statement. 


DDRECORD=record-name 
Specifies the data definition record and consists of one to seven alphanumeric 
characters. The first character must be alphabetic. 


If KATAKANA=YES is specified in the NETWORK section, the record name may 
consist of Katakana characters. 


If omitted and the DFILE parameter is specified, the name of the data definition 
record is assumed to be the same as the defined file name. If both parameters are 
omitted, no data definition record is assumed to exist for this action, unless a 
record name has been placed (or left) in the DATA-DEF-REC field of the PIB by the 
preceding action. 


4.3.8.6. Naming the Defined File for This Action (DFILE) 


The DFILE keyword parameter identifies the defined file or subfile to be accessed by 
this action. It must be specified if the DDRECORD parameter is specified. When the 
action is scheduled, IMS places this name in the DEFINED-FILE-NAME field of the PIB, 
unless a file name has been left in that field by the preceding action. 


The file name specified with this keyword is the same as the file-name used in your 
action program’s function calls to defined record management, and is_ the 
defined-file-name supplied via the DEFINED FILE statement in your input to the data 
definition processor. 


The response to the DFILE keyword parameter must be different from the name of any 
user data file named in a FILE section or via a FILES keyword parameter in any ACTION 
section in this configuration. 


DFILE=filename 
Specifies the defined file and consists of one to seven alphanumeric 
characters; the first character must be alphabetic. 


lf KATAKANA=YES is specified in the NETWORK section, the file name may 
consist of Katakana characters. 


If omitted, no defined file is accessible by this action, unless a file name has been 
placed (or left) in the DEFINED-FILE-NAME field of the PIB by the preceding action. 
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4.3.8.7. Specifying Editing Requirements for Input Messages (EDIT) 


The EDIT keyword parameter specifies the editing requirements for input messages to 
this action. 


When a terminal operator enters an input message, ICAM creates DICE sequences from 
the input terminal cursor movements. If you specify EDIT=tablename, EDIT=FCCDICE, 
or EDIT=c, or if you omit this parameter, IMS removes these DICE sequences from the 
message text before delivering the message to the action program. DICE sequences for 
carriage return are replaced by blanks (X‘40’), and other DICE sequences are simply 
deleted and not replaced. 


If you specify EDIT=NONE, IMS does not remove DICE sequences from input 
messages, and your action program must be prepared to process them. 


If you specify EDIT=tablename, the capability for expanded input editing is also included 
in your online IMS load module. In addition to removing DICE sequences, IMS edits 
input messages according to the edit table generated by the ZH#EDT utility for this 
action and written to the NAMEREC file. Generating of edit tables is described in the 
IMS action programming manuals. 


EDIT=c 
Specifies a character to be used as the field separator in input messages to 
this action. IMS removes DICE sequences and the specified character. If the 
specified character is a blank (or if the keyword is omitted), IMS retains a 
single blank but suppresses repeated blanks. If repeated blanks are to remain 
in the message, the terminal operator should enclose the message with 
apostrophes. 


EDIT=FCCDICE 
Specifies that IMS is to remove FCC and DICE sequences from input 
messages, replace DICE carriage return sequences with blanks (one blank for 
each carriage return), and retain repeated blanks. Do not use this specification 
for RPG Il action programs. 


EDIT=NONE 
Specifies that no editing is to be performed for input messages; DICE and FCC 
sequences are not removed from the input message text. Do not use this 
specification for RPG Il action programs. 


EDIT=tablename 
Identifies the 2- to 7-alphanumeric-character name of the edit table to be used 
with this action. 


if this keyword is omitted, a blank character is assumed as the field separator in 
input messages. IMS retains a single blank but suppresses repeated blanks. IMS 
removes DICE sequences from the input message text but replaces carriage return 
DICE sequences with blanks (one blank for each carriage return). 
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4.3.8.8. Specifying FCC Editing Requirements for Input Messages (FCCEDIT) 


Input messages from a UTS or workstation terminal often contain field control character 
(FCC) sequences. Your action programs may or may not be prepared to process these 
sequences. The FCCEDIT parameter determines whether or not IMS removes these FCC 
sequences from the text of a message before delivering the message to an action 
program. 


When you specify EDIT=c, EDIT=FCCDICE, or EDIT=tablename or omit the EDIT 
parameter, IMS removes DICE sequences from the text of input messages. The 
FCCEDIT parameter lets you choose whether or not you also want FCC sequences 
removed from the message text. If you omit FCCEDIT, IMS assumes FCCEDIT=YES. 


When you specify EDIT=NONE, IMS does no input message editing at all. FCC 
sequences are not removed from input messages regardless of your FCCEDIT 
specification. 


FCCEDIT=NO 
Specifies that IMS is not to remove FCC sequences from the input message to 
this action. 


FCCEDIT=¥ ge 
Specifies that IMS is to remove FCC sequences from the input message to this 
action. 


4.3.8.9. Naming the Data Files Accessed Directly by This Action (FILES) 


With the FILES keyword parameter, you name each individual ISAM, MIRAM, DAM, or 
SAM files to be accessed directly by this action. Do not include the name of any user 
data file that contributes to a defined file for this action. 


The FILES keyword parameter allows multiple responses: you may specify several file 
names but must separate them with commas. 


Each user data file specified with the FILES keyword parameter must also be described 
to the configurator with its own FILE section. 


FILES=file-name-1[,...,filename-n] 
Specifies the user data files to be accessed by this action directly. File names 


must be one to seven alphanumeric characters; the first character must be 
alphabetic. 


If the FILES keyword parameter is omitted, no user data files may be accessed 
directly by this action, which is limited therefore to access of a defined file. 
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4.3.8.10. Specifying Input Message Area Length (INSIZE) 


The INSIZE keyword parameter specifies the input message area (IMA) length for 
messages to be handled by this action. Unlike the OUTSIZE keyword parameter, which 
specifies the maximum length for the output message area, the INSIZE keyword does 
not specify a maximum. If the actual input message received exceeds the specified 
length, an IMA large enough to accommodate it is allocated; there is no truncation. 
Similarly, if the INSIZE keyword is not specified, an IMA is allocated to accommodate 
the length of each actual message read. 


If this action uses expanded input editing (EDIT=tablename), you must include the 
INSIZE parameter and specify a length at least as large as the length of the message 
defined in the edit table. To determine the length needed, add the values specified for 
all the LEN parameters in the edit table generation. (See the IMS action programming 
manuals.) You can also specify INSIZE=STAN if the standard message size is as large 
or larger than the length the edit table requires. 


INSIZE=n 
Indicates the length, in bytes, of the input message area. The value n must 
include the input message length and accommodate any DICE sequences, 
FCCs, or control characters in the message text. The specified length must not 
be greater than the lengths specified by CDASIZE in this section or INBUFSIZE 
(in the GENERAL section). 


INSIZE=STAN 
Allocates an area large enough to accommodate the standard message size. 
The standard message size is established by the CHRS/LIN and LNS/MSG 
parameters in the GENERAL section. 


4.3.8.11. Specifying Size of Largest Action Program (MAXSIZE) 


This parameter specifies the size of the largest nonresident action program that may be 
scheduled to satisfy this action. 


MAXSIZE=n 
Specifies the size, in decimal bytes, of the largest nonresident action program 
for this action. 


If MAXSIZE=O is specified, IMS assumes that all action programs for this action 
are resident programs. If the MAXSIZE keyword is omitted, IMS assumes that the 
first program to receive control for this action is the largest nonresident program, 
or that there is only one program for this action. 


You must include the MAXSIZE keyword parameter if you intend to use the action 
with immediate internal or delayed internal succession under single-thread IMS. For 
multithread, MAXSIZE need be specified only if the action uses immediate internal 
succession. Failure to adhere to this guideline causes the online error message, 
MAXSIZE TOO SMALL, to be issued when an attempt is made to execute this 
action. 
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4.3.8.12. Specifying Number of Concurrent Users (MAXUSERS) 


The MAXUSERS keyword parameter specifies the maximum number of concurrent users 
allowed for this action; it is applicable only to multithread IMS configurations. 


MAXUSERS=n 
Specifies the maximum number of concurrent users. The default value is 3. 


This value puts an upper limit on the number of users that can be active at one 
time for this action. Thus, MAXUSERS should be set to a value such that, when 
this limit is reached, it is pointless to schedule any more users for this action. 


4.3.8.13. Specifying Output Message Area Length (OUTSIZE) 


The OUTSIZE keyword parameter specifies the output message area (OMA) length for 
this action. 


OUTSIZE=n 
Specifies the maximum length, in bytes, of the OMA for this action. The 
maximum length, n, consists of the length of your output message text 
(including all DICE sequences, FCCs, and control characters it contains). The 
length must not be greater than the value specified in the INSIZE parameter. 


OUTSIZE=STAN 
Allocates an area large enough to accommodate the standard message size. 
The standard message size is based upon the CHRS/LIN and LNS/MSG 
parameters you specify in the GENERAL section. 





When you specify OUTSIZE=STAN and the action is entered from a terminal 
with a larger screen size than the OUTSIZE configured, IMS allocates an output 
message area large enough to accommodate the actual screen size. 


If you use the OUTSIZE=n format, the way you calculate the n value depends on 
whether or not you call on screen format services in this action and whether you 
use the dynamic main storage feature. 


If this action calls on screen format services and the screen format is built in the 
output message area, the output message area must be large enough to contain 
the screen format buffer constructed by the screen format coordinator. This buffer 
contains the variable output data, display constants, and device control characters. 


If you use the dynamic main storage feature, you do not have to use the formula for 
screen format services because IMS builds the screen format in a dynamic buffer 
outside the program area. (You indicate dynamic main storage in your action programs 
that use screen formats.) 
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lf you do not use dyanamic main storage, you must specify a message area large 
enough to contain the screen format buffer. To determine the OUTSIZE needed for a 
screen format, use the following formula: 


format-length * format-width + (9«control-char) + 200 
where: 


format-length 


Is the number of lines in the format, determined by cursor placement at 
format generation time. 


format-width 


Is the number of characters per line of the display terminal at which the 
screen format was generated. 


control-char 
Is the number of control character sequences. To determine this number, 
add the number of variable fields, the number of display constants, the 
number of new lines, and the number of special characters (such as ! and 
.) used in variable fields. 


When the action program requests a screen format and the OUTSIZE is not 
large enough to contain the format buffer, IMS returns an error code in the 
program information block. IMS also places the actual length needed for the 
format buffer into the text-length field of the OMA header. 


If this action does not use a screen format, use the following formula, rounding the 
result up to the next double-word boundary: 


(CHRS/LIN+ 4)*«(LNS/MSG) + 24+ (5«(number of FCCs)) 
where: 


CHRS/LIN 
Is the value specified for message line length. 


4 
Represents the length of a DICE sequence for each message line. 


LNS/MSG 
Is the value specified for number of lines per message. 


24 
Represents the length of the 16-byte OMA header plus an allowance of 
eight bytes for two additional DICE sequences (for example, to initiate, 
clear the screen, or reposition the cursor). 
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5«(number of FCCs) 
This value can be ignored if your network does not include UTS or 
workstation terminals. The number of field control characters (FCCs) 
should equal the greatest number of FCCs that will appear in the output 
message. 


At run time, your action program may specify a shorter output message length by 
moving an appropriate value into the text length field of the OMA header before 
transmitting each message. This value must include four bytes for the 2-byte text length 
field itself and the 2-byte auxiliary-id field that precedes your message text; it must also 
allow for the DICE sequences and any other control characters embedded in your text. 
The resulting output message length may never exceed the OMA area length specified 
by the OUTSIZE parameter. 


If the OUTSIZE keyword parameter is omitted, no area is allocated for output 
messages. 


4.3.8.14. Specifying Size of COBOL Shared Code Data Area (SHRDSIZE) 


This keyword parameter specifies the size of the shared code work area for a COBOL 
action program; it is usually not specified in a single-thread IMS system. 


if a COBOL action program uses a volatile work area, IMS saves and restores it in the 
activation record for the program. If your COBOL action program is compiled under the 
PARAM OUT=(M) option of the extended COBOL compiler or the IMSCOD=YES option 
of the 1974 American National Standard COBOL compiler, the printer displays the size 
of the shared code volatile data area, in decimal bytes, immediately prior to the COBOL 
COMPILATION COMPLETE message. The size of the volatile work area, if any, increases 
the size of the activation record and must be considered in calculating the latter. Refer 
to Appendix B. 


SHRDSIZE=n 
Specifies the length, in bytes, of a shared code, volatile data area in a COBOL 
action program. 


If omitted, no shared code volatile data work area is allocated. 


4.3.8.15. Specifying Lowercase-to-Uppercase Translation (TRANSLAT) 


The TRANSLAT keyword parameter specifies whether lowercase-to-uppercase 
translation is to be performed on input messages for this action. It affects only the 
lowercase alphabetic characters a, b, c,...,z, which are translated to uppercase alphabet. 
All other characters in the input message are unchanged. 





TRANSLATS 
Specifies no translation and is the default assumption. 


TRANSLAT=YES 
Specifies lowercase-to-uppercase translation. 
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& NOTE: 


lf KATAKANA=YES is specified in the NETWORK section and input is from a 
Katakana terminal, no lowercase-to-uppercase translation takes place, even if 
TRANSLATE=YES is specified. 


4.3.8.16. Specifying Size of the Work Area (WORKSIZE) 
The WORKSIZE keyword parameter specifies the size of the work area for this action. 


This size must be a 256-byte multiple if the action accesses a DAM file and uses the 


work area as a record area, or if the action accesses data files stored on a sectorized 
disk. 


If this action accesses a DMS data base and you include the USING ACTIVATION 
RECORD clause in the schema section of your action program or data definition, you 
must allocate a continuity data area or work area large enough to contain the DMCA or 
subschema records (or both). Your program determines where these records are placed. 
Refer to the IMS/DMS interface user guide, UP-8748 (current version). 
WORKSIZE=n 
Specifies the size, in bytes, of the work area and must not exceed 32,767. In 
a single-thread system, n must be a multiple of eight bytes. 


@ If omitted, no work area is allocated. 


4.3.9. Describing Each Action Program — the PROGRAM Section 


The PROGRAM section describes the user action programs and subprograms. A 
PROGRAM section must be included for each action program and subprogram. 


Format: 


PROGRAM program-name 


is 5 | 
YES 
ies {" ! 
YES 
fae {" ie ] 
YES 
“| RNT 
"i 


© PROGRAM BASIC RESIDE=YES TYPE=RNT ERET=YES 
PROGRAM COMPUT TYPE=SER SUBPROG=YES 
PROGRAM EDIT TYPE=RNT RESIDE=YES 














Example: 
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4.3.9.1. Naming the Action Program (program-name) 


program-name 
Is the name of the program being described and consists of one to six 
alphanumeric characters. The first character must be alphabetic. 


4.3.9.2. Specifying Return of Control (ERET) 


The ERET keyword parameter specifies whether control should be returned to this 
program if one of its requests to IMS is unsuccessful. 








ndicates that control is not to be returned and the transaction is aborted if an 
error occurs. 


ERET=YES 
Specifies that control is be returned to the user action program if an error 
occurs and status code 3 or 4 (invalid request or I/O error) is set. 


If omitted or NO is specified, an unsuccessful request results in abnormal 
termination of the transaction. The ERET keyword has no effect for status codes O, 
1, or 2 in the program information block (PIB). 


4.3.9.3. Specifying Action Program Residence (RESIDE) 
The RESIDE keyword parameter specifies whether this program is resident (that is, 
permanently loaded into the main storage pool area at initialization time) or transient 


(loaded only as required by transaction processing). 


RESIDE=4 
Indicates that the program is transient and is the default assumption. 





RESIDE=YES 
Indicates that the program is resident. 


4.3.9.4. Identifying a Subprogram (SUBPROG) 
The SUBPROG keyword parameter specifies whether the program being described is a 


subprogram. Since only resident subprograms are permitted, the configurator 
automatically includes the RESIDE=YES parameter when SUBPROG=YES is specified. 





Indicates that this is not a subprogram and is the default assumption. 


SUBPROG=YES 
Specifies that this is a resident subprogram. 
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4.3.9.5. Specifying Action Program Reentrance/Reusability (TYPE) 


The TYPE keyword parameter specifies whether the program is reentrant, serially 
reusable, or shared code. A COBOL action program may not be reentrant; it is usually 
shared code. 


TYPE=RNT 


Indicates that the program is reentrant. Invalid if the action program is written 
in COBOL. 





Indicates that the program is serially reusable and is the default assumption. 


TYPE=SHR 
Specifies that the program is sharable. If specified for a _ single-thread 
configuration, the program is treated as serially reusable. 


4.3.10. Replacing UNIQUE Language Elements — the LANGUAGE Section 


The LANGUAGE section is a repeatable section that allows you to create a UNIQUE 
language set, called a lexicon. The new lexicon partially or completely replaces the 
standard UNIQUE lexicon. Thus, you can modify as many or as few UNIQUE language 
elements as you wish to suit your own application. For example, you may wish to 
create a French language set by replacing all the standard UNIQUE language elements 
with their French equivalents, or you may wish to replace certain elements in the 
standard UNIQUE lexicon with abbreviated forms. 


The standard UNIQUE lexicon is listed in Appendix E. When you do not modify a 
standard language element by including it in a new lexicon, your terminal operators 
must enter that element as it appears in the appendix. 


If you specify UNIQUE=YES or UNIQUE=RES in the OPTIONS section and do not 
specify a LANGUAGE section, the configurator generates a default lexicon record (see 
Appendix E) and the OPEN transaction code. If you specify a LANGUAGE section, the 
default lexicon specifications are replaced by the LANGUAGE section specifications and 
the default transaction code of OPEN is replaced with a transaction code generated 
from the lexicon name. 


If you specify UNIQUE=NO in the OPTIONS section, the configurator does not generate 
a default lexicon record. Any LANGUAGE section input is ignored. 


Format: 


LANGUAGE lexicon-name 
lLanguage-element=replacement 


language-element-n=replacement-n 
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Example: 


LANGUAGE OUVREZ OPEN=OUVREZ MORE=PLUS NEXT=PROCHAIN 
CHANGE=CHANGER SHOW=MONTRER 


Five standard UNIQUE language elements are assigned new values: OPEN, MORE, 
NEXT, CHANGE, and SHOW. 


4.3.10.1. Specifying the Lexicon Name (lexicon-name) 


This positional parameter specifies the name of the lexicon and the transaction code to 
be created. 


lexicon-name 
Specifies the name of the UNIQUE lexicon record and the transaction code. For 
single-thread IMS, it consists of one to five alphanumeric characters, the first 
of which must be alphabetic. For multithread, it consists of one to seven (see 
TRANLEN keyword specification in GENERAL section) alphanumeric characters, 
the first of which must be alphabetic. 


4.3.10.2. Specifying UNIQUE Language Element to Be Replaced 
(language-element=replacement) 


The language element parameter specifies the UNIQUE language element to be replaced 
and its replacement. The replacement is the term that a terminal operator enters in 
place of the standard language element or that UNIQUE displays in place of the 
standard language element. 


language-element=replacement 
Language-element is the word or symbol to be replaced and must be one of 
those listed in Appendix E. The replacement must not exceed the maximum 
length listed beside the original. It must not contain embedded spaces. 
Punctuation symbols and arithmetic operators must not be used as 
replacement values. If KATAKANA=YES is specified in the NETWORK 
section, the replacement may consist of Katakana characters. 


4.3.11. Identifying Remote Systems Where Transactions Can Be Processed — 
the LOCAP Section 


The LOCAP section is required when distributed data processing is used. It identifies a 
transaction system (IMS) on a remote node where DDP transactions can be processed 
or that can route DDP transactions to this IMS system for processing. Transactions can 
be sent to a remote node system by directory routing, program routing, or operator 
routing. LOCAP is a repeatable section. 
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LOCAP locap-name 


RCHAR=routing-character 
Example: 


LOCAP PRG1 RCHAR=; 
NOTE: 


To use distributed data processing with IMS, you must have the IMS transaction facility 
in your OS/3 software, define a global ICAM network definition that supports 
distributed data processing (see 2.3.2.4), configure multithread IMS, and include at least 
one LOCAP section in the configuration. 


4.3.11.1. Identifying the Remote System (locap-name) 


The locap-name parameter specifies the name of a remote system to which transactions 
can be routed or which routes transactions to this IMS system. This name must match 
the label of a LOCAP macro in your ICAM network definition. 


Locap-name 
Specifies the name of a remote IMS system. The name consists of one to four 
alphanumeric characters, the first of which must be alphabetic. The locap-name 
specified cannot be the same as the name specified in the CUP keyword 
parameter of the NETWORK section. 


4.3.11.2. Specifying a Routing Character (RCHAR) 


The RCHAR keyword parameter specifies a routing character that is used in operator 
routing to identify the remote system. The terminal operator prefixes a transaction code 
with this character and a period. Each remote system must have its own routing 
character, which must be different from the priority character (if any) specified in the 
UCHAR parameter of the GENERAL section. 





UP-8364 Rev. 7 SPERRY UNIVAC OS/3 4-102 
IMS SYSTEM SUPPORT FUNCTIONS 


RCHAR=routing-character 
Specifies a routing character to identify the remote system in operator-routed 
transactions. The routing character can be any alphabetic, numeric, or special 
character except the blank. If KATAKANA=YES is specified in the NETWORK 
section, you can designate a Katakana character. Do not use the same routing 
character for more than one remote system. 


When a terminal operator wants to route a transaction to the remote system identified 
by the locap-name parameter, he enters the routing character, followed by a period. 
Then he enters the transaction code and message. For example, to route a UNIQUE 
transaction to a remote system for which the routing character ; is specified, the 
terminal operator enters: 


;-OPEN INVFILE 


You can also define routing characters in PARAM statements at IMS start-up, whether 
or not you include the RCHAR parameter in the LOCAP section. A routing character 
defined at start-up overrides the RCHAR specification for that IMS session only. 


4.3.12. Defining the Record Management Interface — the DRCRDMGT Section 


The configurator automatically includes defined record management capability in your 
system when you include UNIQUE in your configuration or when you include the DFILE 
parameter in any ACTION section. You use the DRCRDMGT section when you want to 
make defined record management resident in a_ single-thread IMS system. In a 
multithread system, defined record management (if included) is always resident. You 
also use the DRCRDMGT section when you want to use defined record management file 
updating functions with your own action programs. When you configure UNIQUE and 
FUPDATE=YES in the OPTIONS section, the configurator automatically includes defined 
record management file udpating functions. 


Format: 





DRCRDMGT lbs 


od 


Example: 


DRCRDMGT UPDATE=YES RESIDE=YES 


4.3.12.1. Specifying Residence for Defined Record Management (RESIDE) 


In a multithread IMS system, defined record management (if included) is always 
resident. In a single-thread system, you can make defined record management resident 
by coding the RESIDE keyword parameter. A resident defined record management 
improves IMS performance but increases main storage requirements by 2154 bytes. 
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RESIDE=Ne 


Specifies that the transient defined record management request processor 
module is to be included in this single-thread IMS configuration. 


RESIDE=YES 


Specifies that the resident defined record management request processor 
module is to be included in this single-thread IMS configuration. 


4.3.12.2. Specifying Defined Record Management Updating Functions (UPDATE) 


The UPDATE keyword parameter determines whether or not updating functions are to 
be used with defined record management. If you use UNIQUE, the updating functions 
are the UNIQUE commands ADD, DELETE, and CHANGE. If you interface directly with 
defined record management in your own action programs, the updating functions are 
GETUP, PUT, INSERT, and DELETE. 





Indicates that updating capability is not to be included and is the default 
assumption unless UNIQUE is configured. 


UPDATE=YES 
Specifies that updating capability is to be included. Updating capability is 
automatically included if UNIQUE is configured and FUPDATE=YES is specified 
in the OPTIONS section. 


4.4. CONFIGURATOR ERROR PROCESSING 


The configurator generates errors at configuration time. It flags each error detected in 
the printed configuration listing on the line after the statement in error. The format for 
error listing is: 


***ERROR error-code message-text 


Table F-2 lists the error codes, the diagnostic messages associated with each, the 
message description, and the configurator action. 


The configurator sets the UPSI byte to X‘80 for fatal errors and X’40 for warning 
errors. Fatal errors are |/O errors (documented in the system messages 
programmer/operator reference, UP-8076 (current version)) and initialization errors (error 
codes 0101, 0102, 0103, and 0104 in Table F-2). All other errors in the table are 
warning errors. 


The IMSCONF jproc checks the UPSI byte and skips the assembly and online module 
linkage steps when the setting is X‘80. It does not check for a setting of X‘'40. You 
can test for the X‘40 setting by including a // SKIP statement in the job control stream 
at configuration. Refer to the current versions of the job control user guide, UP-8065, or 
programmer reference, UP-8217, for a description of the SKIP job control statement 
and the system service programs (SSP) user guide, UP-8062, or programmer reference, 
UP-8209, for more information about the UPS! byte. 
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If the configurator cannot load the CCA module because inadequate main storage was 
allocated or because of an error in the CCA linkage, the message 





CCA LOADING ERROR ~ ERROR CODE nn 
is displayed on the system console. The configurator continues executing, but it 
assumes a network containing only one terminal. The UPSI byte is set to X‘80 and the 
assembly and linkage steps are omitted. 


See the system messages programmer/operator reference, UP-8076 (current version), 
for an explanation of the loading error code. 


In the configurator listing, the message 

ERRORS ENCOUNTERED - 9@0n 
appears at the end of the CCA linkage. If n is a number other than O, this is evidence of 
a good linkage. If n is O, this means that a bad CCA linkage is generated as a result of 


the following: 


= The CCA object module does not exist in the library file specified by either the 
LIBO or CCA keywords in the IMSCONF jproc. 


a = The resulting linkage editor listing shows that the load module size is zero. 





When this occurs, retry the entire configuration after correcting the error. 
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5. Initiating and Terminating IMS 


5.1. GENERAL 


To initiate an online IMS session, you must first load ICAM and then execute the IMS 
load module created by the configuration process described in Section 4. If you are 
using a global network, you load ICAM, then execute the global user service task 
(GUST) before executing IMS. If you want to perform batch transaction processing in 
offline mode, an active communications network is not required and you need not load 
ICAM before executing IMS. (You must still generate an ICAM network, however, in 
order to configure your IMS load module.) Batch transaction processing is described in 
Section 6. 


The online IMS session is terminated by a command from the master terminal, ZZSHD, 
which causes an orderly shutdown, or ZZHLT, used for emergency termination. 


5.2. ESTABLISHING THE COMMUNICATIONS ENVIRONMENT 

Before executing online IMS, you must load the ICAM symbiont that interfaces with 
your online IMS load module. If you use a global network, you establish the 
communications environment in two steps: 


1. Load the ICAM symbiont. 


2. Execute the global user service task (GUST). 


5.2.1. Loading ICAM 


ICAM is loaded from the system console by keying in the operator command: 


Cn or Mn 
where: 
Cn or Mn 


Is the name specified on the MCPNAME parameter in the COMMCT phase of 
SYSGEN. 
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You can also load ICAM from a job control stream with the statement: 


// ey 
Mn 


This allows you to load ICAM from a workstation instead of asking the console 
operator to do it for you, and it also allows you to load ICAM as part of your IMS 
execution job or as part of a job that executes the global user service task. 
You can use the CC job control statement in two ways: 
1. In a job control stream that loads only ICAM: 
// JOB jobname 
// CC{Cn 
Mn 
/8& 
2. In a job control stream that executes IMS, or if you are using a global network, in a 
job control stream that executes the global user service task. The CC job control 


statement immediately follows the JOB statement. 


When ICAM has been successfully loaded, the message ICAM READY is displayed on 
the system console. 


NOTE: 

When you load ICAM from a workstation, ICAM messages are still directed to the 
operator console. 

5.2.2. Executing the Global User Service Task 

lf you are using a global network, you must execute the global user service task 


program, ML$$GI, after loading ICAM. The example job control stream in Figure 5-1 
executes ML$$GI. 


JOB GUST, , 3000 

DVC 20 // LFD PRNTR 

DVC 50 // VOL DISK@1 // LBL TCIDTF // LFD TCIDTF,,INIT 

DVC 50 // VOL DISKO1 // LBL ICAM.QUEUE1 // LFD DQFILE1,,INIT 


DVC 5@ // VOL DISK®1 // LBL ICAM.QUEUE2 // LFD DQFILE2,,INIT 
OPTION SYSDUMP 
EXEC MLSSGI 


FIN 





Figure 5-1. Sample Job Control Stream for Executing GUST 
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On the JOB statement, GUST requires a minimum main storage allocation of 3000 
hexadecimal bytes. The device assignments for disk buffer and disk queueing files must 
be included in this job stream instead of the IMS execution job stream. 


When GUST is executed, it sends messages to the system console, which the operator 
must respond to. These messages are documented in the ICAM network definition and 
operations user guide, UP-8947 (current version). When the network is loaded, the 
following message is displayed at the system console: 


MC#43@ GUST ACTIVE FOR CCA network-name 


When this message appears, you can execute IMS. 


5.3. EXECUTING THE IMS LOAD MODULE 


IMS is executed as a user job, with a standard job control stream submitted from the 
card reader or workstation. The name of the load module you execute is the name 
specified on the LOADM parameter of the IMSCONF jproc at configuration. The default 
name for a_ single-thread DTF configuration is ZS#IMS; for a multithread DTF 
configuration, ZO#IMS; for a single-thread CDM configuration, ZS$IMS; for a multithread 
CDM configuration, ZOSIMS. 


When the online IMS module is successfully loaded, the message IMS READY is sent to 
each terminal that is in a ready state (except terminals for which IMSREADY=NO was 
specified in the TERMINAL section). 

After IMS is loaded, dynamic terminals in a global network can establish and terminate 
sessions by using the $$SON and $$SOFF commands. See the IMS terminal users 
guide, UP-9208 (current version). Dynamic terminals do not receive the IMS READY 
message. Instead, the message SESSION PATH OPEN is sent at session establishment. 
5.3.1. Parameter Statements in the Control Stream 


PARAM statements in the IMS execution job control stream allow you to specify: 


= whether IMS internal files and tables are to be initialized or information retained 
from a previous session; 


# ~=rollback of data files at system start-up; 
m closing or extending of a disk trace file from a previous session; 


= ~ routing characters that identify transactions to be processed by a particular remote 
system in a DDP environment; and 


= ~= batch transaction processing in online or offline mode. 
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The format of the PARAM statements for IMS execution is: 


, 


' i 


[// 
C// 
C// 


g 


// 


(// 


PARAM 





oa 


| 


PARAM STARTUP=(€ : 
COLD 
WARM 


PARAM TRCFILE=(CLOSE 
EXTEND 


PARAM LOCAP=(lLocap-name,routing-character ) ] 
PARAM DDPBUF=n] 
PARAM DDPSESS=n] 


onan 





YES 


PARAM{BA = (9S 
BATCH} {OFFLINE 


ONLINE 
PARAM IN=module-name/filename] 


statements may be specified in any order except that BATCH and IN (when 


used) must be the last parameter statements in the job control stream. If PARAM IN is 
used, it must follow PARAM BATCH. 


5.3.1.1. 


Specifying Type of Start-up (START/RESTART, STARTUP) 


The START or RESTART parameter is used for multithread IMS only. It tells IMS 
whether to initialize control tables in the NAMEREC file or maintain statistical and 
terminal information from a previous session; also, whether to reinitialize the LDPFILE. If 
you omit this parameter, control tables and the LDPFILE are initialized. 


// PARAM 





Specifies initialization or reinitialization of control tables in the NAMEREC file 
and of the LDPFILE (if configured) at start-up of a multithread IMS system. 
Should be used for the initial start-up. 


// PARAM RESTART 


Specifies that statistical, terminal, program, and action information in the 
NAMEREC file from the previous session is to be carried forward into the new 
session. Statistical data generated by the ZSTAT transaction reflects multiple 
sessions. The LDPFILE from the previous session (if used) is reused. 


The STARTUP parameter is optional for both single-thread and multithread IMS users. It 
specifies whether the audit file is to be initialized and whether transactions active at 


t 


termination of the previous session are to be rolled back. 
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// PARAM STARTUP AN 
Specifies initialization of the AUDCONF file (or AUDFILE and CONDATA files) at 
start-up. This option is used for the initial start-up after a successful shutdown. 


// PARAM STARTUP=COLD 

Specifies that the AUDCONF file (or AUDFILE and CONDATA files) is not to be 
initialized at start-up, but no file rollback is to be performed. This option is 
generally used after offline recovery. If you have configured a terminal output 
message file (TOMFILE), IMS appends the DLMSG transaction code to the IMS 
READY message sent to each terminal. Terminal operators can display the last 
valid message output to their terminals by pressing the TRANSMIT key. You 
must specify TOMFILE=YES in the configurator OPTIONS section if you want 
to use the cold start feature. 


// PARAM STARTUP=WARM 
Specifies that all files against which transactions were active at termination or 
system failure are to be rolled back to a consistent state. IMS appends the 
DLMSG transaction code to the IMS READY message sent to each terminal; 
terminal operators can display the last valid message output to their terminals 
by pressing the TRANSMIT key. You must specify TOMFILE=YES in the 
configurator OPTIONS section to use the warm start feature. 


If no PARAM STARTUP statement is included, IMS initializes the audit file. 
However, if it is specified incorrectly, IMS terminates with the message: 


PARAM CARD ERROR 


5.3.1.2. Extending a Tape Or Disk Trace File (TRCFILE) 


If you want to continue the same trace file from a previous session instead of starting a 
new one, you must specify this in your job control stream at start-up. The way you 
specify extension of a trace file depends on whether that file is on magnetic tape, disk, 
or diskette. 


You specify extension of a magnetic tape trace file with the EXTEND parameter of the 
LFD job control statement: 


// LFD TRCFILE,,EXTEND 


lf your tape trace file was left open at the end of the previous session because of 
system failure, you must use the tape copy routine, ZC#TCP, to copy it onto another 
tape volume and close it properly. You then assign it in the job control stream in the 
same manner. 


For a disk or diskette trace file, you use the PARAM TRCFILE statement to specify 
continuation of the same file. If the file was properly closed at the termination of the 
previous session, you specify PARAM TRCFILE=EXTEND. If your trace file was left 
open, you specify PARAM TRCFILE=CLOSE; IMS first closes the file and then extends 
It. 
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// PARAM TRCFILE=CLOSE 
Specifies that IMS is to close the disk/diskette trace file before initiating online 
operations. All records in the trace file are validated; then the trace file is 
extended, starting after the last valid record. This option may be used with 
warm restart after a system crash if you do not use the offline recovery utility, 
ZC#TRC, to recover your data files. 


// PARAM TRCFILE=EXTEND 
Specifies that IMS is to extend the disk/diskette trace file used in the previous 
session, starting after the last valid record. This option is used after a normal 
shutdown or after offline recovery of your data files. 


If the TRCFILE parameter is specified when no trace file has been assigned in the 
job control stream, the following message is issued: 


OPEN ERROR ON TRCFILE 


If a disk/diskette trace file is assigned in the job control stream and the TRCFILE 
parameter is omitted, IMS assumes a new trace file is being used and starts writing 
from the first record. 


5.3.1.3. Specifying a Routing Character (LOCAP) 


To indicate that terminal input messages prefixed by a particular routing character are to 
be processed by a particular remote system, you can insert a LOCAP parameter 
Statement in the job control stream for executing IMS. The remote system must be 
defined in a configurator LOCAP section. A routing character specified in a PARAM 
statement overrides any routing character specified in the LOCAP configurator section 
for that remote system for this IMS session only. The PARAM LOCAP statement may 
be repeated for each remote system. 


// PARAM LOCAP=(locap-name,routing-character) 
Specifies that all terminal messages prefixed by the routing character and a 
period are to be sent to the remote system identified by locap-name for 
processing. A routing character can be any alphabetic, numeric, or special 
character except the blank. If KATAKANA=YES is specified in the NETWORK 
section, you can specify a Katakana character as the routing character. 


When a terminal operator wants to route a transaction to the remote system identified 
by locap-name, he enters the routing character, followed by a period. Then he enters 
the transaction code and message. For example, to route a UNIQUE transaction to a 
remote system for which the routing character A is specified, the terminal operator 
enters: 


A.OPEN SALES 
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5.3.1.4. Specifying Distributed Data Processing Message Size (DDPBUF) 


You can override the value specified in the DDPBUF parameter of the GENERAL section 
of the configuration by including a PARAM DDPBUF statement. This changes the size of 
the DDP message buffer for the current IMS session only. 


// PARAM DDPBUF=n 


Specifies the DDP message size (in multiples of 256) for this IMS session. The 
maximum value allowed is 4352. 


5.3.1.5. Specifying Number of DDP Sessions (DDPSESS) 


You can decrease the value specified in the DDPSESS parameter of the GENERAL 
section of the configuration by including a PARAM DDPSESS statement. This changes 
the number of distributed data processing sessions for the current IMS session only. 


// PARAM DDPSESS=n 
Specifies the maximum number of DDP sessions that can be active at one 
time. Specify a value between 2 and 25, but not more than the value specified 
in the DDPSESS parameter at configuration. 


5.3.1.6. Monitoring Online IMS (DEBUG) 


If you have a problem with online IMS, you should include the DEBUG parameter when 
you start up IMS. In this way, additional IMS and terminal status data is recorded during 
processing and is included when you take a dump. This dump should be submitted 
whenever you report a problem. The DEBUG feature is available only in multithread IMS. 


// PARAM DEBUG=N6 
Specifies that additional IMS and terminal status information is not to be 
recorded. This is the default value. 





// PARAM DEBUG=YES 
Specifies that additional IMS and terminal status information is to be recorded. 
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5.3.1.7. Processing Batch Transactions (BATCH) 


To process batch transactions in either offline or online mode, you insert a BATCH 
parameter statement in the job control stream for executing IMS. If your batch input is 
in the form of source modules filed on disk, you also insert a PARAM IN statement for 
each such module. The BATCH and IN parameters follow any other PARAM statements 
in the job control stream, and the PARAM BATCH statement precedes any PARAM IN 
statements. Complete details about batch transaction processing, including a sample job 
control stream, are in Section 6. 


BATCH 
Specifies that batch transactions will not be processed in this execution of 
IMS. 


// ge ba 


BATCH 
Specifies that batch transactions are to be processed in offline mode, that is, 
without an active terminal network. 


// mee poe 


// mene on 
BATCH 
Specifies that batch transactions are to be processed in online mode. Online 
mode requires an active communications network. Batch processing in online 
mode is controlled by the ZZBTH master terminal command (6.6.1). 





5.3.1.8. Specifying an Input Module That Is on a Disk File (IN) 


If you have created a file that contains your input source module for batch processing 
(rather than embedding the card images in the control stream), specify the file and 
module names in a PARAM IN statement. PARAM IN statements must follow the 
PARAM BATCH statement. You may include any number of PARAM IN statements (or 
none), and they may appear in any order. 


module-name 
Specifies the name of the input source module. 


file-name 
Specifies the name of the file that contains your module. 


5.3.2. Job Control Stream for IMS Execution 


A standard job control stream for executing the online IMS load module is illustrated in 
Figure 5-2. For detailed information on the job control statements in the illustration, 
refer to the current version of the job control user guide, UP-8065, or programmer 
reference, UP-8217. & 
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€& JOB jobname,,min[,,tasks] 
: OPTION( DUMP 


*JOBDUMP 
SYSDUMP 
DVC 20 // LFD PRNTR 
DVC logical-unit-no // VOL vol-ser-no // LBL file-id 
LFD data-file-name 
DVC logical-unit-no // VOL vol-ser-no // LBL file-id // LFD NAMEREC 
[// DVC lLogical-unit-no // VOL vol-ser-no // LBL file-id // LFD AUDFILE}® 
[// DVC logical-unit-no // VOL vol-ser-no // LBL file-id // LFD CONDATAY® 
// DVC logical-unit-no // VOL vol-ser-no // LBL file-id // LFD STATFIL,,INIT 
// OVC logical-unit-no // VOL vol-ser-no @ 
[// EXT ST,C,,BLK, (block-length,no-of-blocks) ] 
// LBL file-id // LFD disk-buffer-file-name 
// DVC Logical-unit-no // VOL vol-ser-no 
// EXT ST,C,,CYL,no-of-cylinders] 
// LBL file-id // LFD disk-queueing-file-name 


& DVC lLogical-unit-no // VOL vol-ser-no-1[,...vol-ser-no-n] 
EXT ST,C,,CYL,no-of-cylinders] 
LBL file-id[{,file-serial-no] // LFD TRCFILE[,,EXTEND] 
DVC logical-unit-no // VOL vol-ser-no // LBL file-id 
LFD load-lib-name ] 
DVC logical-unit-no // VOL vol-ser-no // LBL file-id // LFD LOAD} 
DVC logical-unit-no // VOL vol-ser-no 
EXT ST,C,,CYL,no-of-cylinders 
LBL file-id // LFD LDPFILE 
DVC Logical-unit-no // VOL vol-ser-no // LBL file-id // LFD TCO1FMTF | 
DVC Logical-unit-no // VOL vol-ser-no // LBL file-id // LFD TCO2FMTF] 
EXEC load-module-name[, load-lib-name],1 
PARAM parameter -statement ] 





NOTES: 
@ The AUDFILE and CONDATA files in a multithread IMS system are replaced by the AUDCOMF file in a single-thread 
system. 


@ In a global network, assign ICAM files in GUST job control stream. 


& Figure 5-2. Job Control Stream for Executing Online IMS 
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In the JOB job control statement (line 1), the min parameter specifies the size of the job 
region, calculated according to the guidelines in Appendix B. The tasks parameter is 
required for multithread IMS only. It specifies the maximum number of tasks that will be 
active at any one time; at least 4 must be specified. For information on the optimum 
number of tasks to assign, see Appendix C. 





An OPTION statement (line 2) must be included to enable IMS to generate a snap dump 
when an action program or UNIQUE abnormally terminates. Refer to the job control 
manuals previously cited for information on dump options. Assignment of a printer (line 
4) is also required for this purpose. 


The device assignment sets for data files (line 4 and succeeding lines), the NAMEREC 
file (line 5), and an ICAM file for message buffering (lines 9-11) are always required. 
The LFD-name for the disk buffering file must match the label on the DISCFILE macro in 
the ICAM network definition (Section 2). ICAM files for disk queueing of output 
messages (lines 12-14) are also required if specified in the network definition. Their 
LFD-names must also match the labels on the DISCFILE macros specifying these files. If 
you use a global network, you must assign the ICAM files in the GUST job stream 
instead of here. For information on allocating ICAM files, refer to the ICAM network 
definition and operations user guide, UP-8947 (current version). 


The AUDFILE and CONDATA files assigned on lines 6 and 7 are for a multithread 
system and would be replaced by the AUDCONF file in single-thread. The AUDFILE is 
always required, and the CONDATA file is required for UNIQUE, if you use a continuity 
data area in any of your action programs or if you have configured a TOMFILE. You do 
not assign the TOMFILE in the job control stream because it is a partition of the 
multithread CONDATA file or the single-thread AUDCOMF file. 





The STATFIL assigned in line 8 is required if you plan to use the ZSTAT transaction 
(with output to STATFIL) or if you specify STATS=YES in the OPTIONS configurator 
section to write statistics to STATFIL at shutdown. 


The trace file assigned on lines 15 through 17 is for offline recovery and may be disk, 
diskette, or tape. The multiple vol-ser-no parameters on the VOL statement and the 
file-serial-no parameter on the LBL statement are needed only for a multivolume tape 
trace file. The EXTEND parameter of the LFD statement also applies only to tape and 
specifies that the same trace file from a previous session is to be continued. The EXT 
statement applies only to a disk or diskette trace file. To estimate the amount of space 
to allocate to this file, multiply the block size (the size of your largest applicable data 
record or output message area plus 104 bytes for the prefix area) by the number of 
updates you expect to perform during the period the trace file is to be used. If you have 
configured both before- and after-images, double this figure. You must also allow for 
rollback and termination records and (if you have configured TOMFILE tracing) an output 
message at each rollback point and at transaction termination. 


Diskette trace files are available in System 80 only. A diskette trace file can be on 
multiple volumes, but all volumes must be online at once. You must have a device 
assignment set for each volume. 
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The EXT job control statement for the ICAM files (lines 10 and 13), trace file (line 16), 
and LDPFILE (line 20) are included only if these files were not allocated previously and 
must be removed from the job contro! stream after the first execution of online IMS. 


The device assignment for a load library file (line 18) is required only if the IMS load 
module is not in the system load library (SY$LOD) on SYSRES. The load-lib-name 
parameter of the EXEC statement (line 23) must match the LFD-name for this file and is 
the library specified by the LIBL parameter of the IMSCONF jproc at configuration. The 
load-module-name on the EXEC statement is the name specified on the LOADM 
parameter of the IMSCONF jproc. 


The LOAD and LDPFILE files assigned on lines 19 and 20 are for using the fast load 
feature. Action programs are stored in LOAD, and IMS copies them into LDPFILE the 
first time they are called by a transaction. The LDPFILE should be 20 percent larger than 
the combined size of all action programs and should not be on the SYSRES volume. 


You must include a device assignment set (lines 21 and 22) for each screen format file. 
You can have one or two files (TCO1FMTF and TCO2FMTF). If either of the format files 
cannot be opened, screen format services will be inhibited. 


The third positional parameter of the EXEC statement must specify a priority of 1. Note 
that IMS must always be the highest priority job running. If IMS is loaded into the 
system while another job with a priority of 1 is executing, you should use the SWITCH 
Operator command to lower the priority of the other job. 


Typical job control streams for executing multithread and single-thread IMS load 
modules in a dedicated ICAM environment are illustrated in the examples that follow. A 
job control stream for batch transaction processing is illustrated in Section 6. 


Example 1 - Executing multithread IMS at initial start-up: 


// JOB I1MS90,,20000,4 
// DVC 20 // LFD PRNTR 
// OPTION SYSDUMP 
// OPR ‘IMS 9@ EXECUTION! 
// DVC 51 // VOL DS1475 // LBL ZL#VEND // LFD VENDOR 
// DVC 51 // VOL DS1475 // LBL ZL#PROD // LFD PRODFIL 
// DVC 51 // VOL DS1475 // LBL ZLHCUST // LFD CUSTFIL 
// DVC 51 // VOL DS1475 // LBL ZLHDUIN // LFD DUEIN 
// DVC 51 // VOL 0S1475 // LBL ZLHDUOT // LFD DUEOUT 
// DVC 52 // VOL DS148® // LBL NAMEREC // LFD NAMEREC 
// DVC 52 // VOL DS148@ // LBL AUDFILE // LFD AUDFILE 
// DVC 52 // VOL DS1480 // LBL CONDATA // LFD CONDATA 
// DVC 52 // VOL DS1480 
// EXT ST,C,,CYL,10 
// LBL TRACE // LFD TRCFILE 
// DVC 52 // VOL DS1480 
// EXT ST,C,,BLK, (256,600) 
// LBL TCIDTF // LFD TCIDTF 
// DVC 52 // VOL DS1489 

continued 
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// EXT ST,C,,CYL,3 

// LBL DQFILE1 // LFD DQFILE1 
// DVC 52 // VOL 081480 

// EXT ST,C,,CYL,3 

// LBL DQFILE2 // LFD DQFILE2 
// DVC 52 // VOL DS1480 

// EXT ST,C,,CYL,3 

// LBL DQFILE3 // LFD DQFILE3 
// DVC 53° // VOL 0S1485 // LBL LOADHLIB // LFD LOADLIB 
// EXEC ZQ#IMS,LOADLIB, 1 

// PARAM START 

/& 

// FIN 





This example executes a multithread IMS load module for the first time. The 
PARAM START statement tells IMS to initialize the control tables in the NAMEREC 
file. The absence of a STARTUP parameter statement means that the AUDFILE also 
will be initialized. A new disk trace file is allocated in this job stream; the EXT 
statement must be removed for subsequent runs. 


Three ICAM disk queueing files and an ICAM disk buffering file are allocated. Their 
LFD names DOFILE1, DOFILE2, and DOFILE3 match the labels of the DISCFILE 
macros in the network definition examples in Section 2. The EXT statements must 
be removed after the initial run. 





The name of the multithread module being executed is ZO#IMS, and it is loaded 
from the LOADLIB library file. A priority of 1 is specified on the EXEC statement. 


Example 2 - Executing single-thread IMS with warm restart: 


// JOB XIMS, ,COOO 

// DVC 26 // LFD PRNTR 

// OPTION DUMP 

// DVC 50 // VOL DISK®@1 // LBL NAMEREC // LFD NAMEREC 

// DVC 50 // VOL DISK®@1 // LBL AUDCONF // LFD AUDCONF 

// DVC 50 // VOL DISK®1 // LBL STATFIL // LFD STATFIL 

// DVC 50 // VOL DISKO1 // LBL TCIDTF // LFD TCIDTF 

// OVC 90 // VOL TAPE@1,TAPE@2,TAPE®@3 // LBL TRACE, TAPEO1 
// LFD TRCFILE,,EXTEND 

// DVC 51 // VOL DISK@2 // LBL DATAFL1 // LFD DATAFL1 

// OVC 51 // VOL DISK@2 // LBL DATAFL2 // LFD DATAFL2 

// OVC 51 // VOL DISK@2 // LBL DATAFL3 // LFD DATAFL3 

// DVC 51 // VOL DISK@2 // LBL SCRFORMAT // LFD TCO1FMTF 
// EXEC LDIMS,,1 

// PARAM STARTUP=WARM 

/& 

// FIN 





This example executes a single-thread IMS load module called LDIMS with a warm 
restart. At start-up, all transactions that were active when the previous session 
terminated will be rolled back. 
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A statistical file is assigned. This file is required if you plan to use the ZSTAT 
transaction or if you specify STATS=YES for automatic recording of statistics at 
shutdown. 


A 3-volume magnetic tape trace file is assigned, and the file is to be extended from 
the last session. If the file was left open at the end of that session, it was copied 
and closed with the ZC#TCP utility before being assigned to this run. Had the trace 
file been on disk, the TRCFILE=CLOSE parameter would have been included in the 
job control stream to close and extend it. The absence of a load library file 
assignment and a load library name on the EXEC statement indicates that the load 
module is stored in $Y$LOD on SYSRES. 


Screen formats are stored in the file named SCRFORMAT. 
Example 3 - Executing IMS in System 80 using a diskette trace file: 


// JOB SYS80, ,DOOO 

// DVC 20 // LFD PRNTR 

// OPTION SYSDUMP 

// DVC RES // LBL NAMEREC // LFD NAMEREC 

// DVC RES // LBL AUDCONF // LFD AUDCONF 

// DVC RES // LBL ICAMFILE // LED TCIDTF 

// DVC 5@ // VOL DATA // LBL EMPLOYEE // LFD EMPLOY 
// DVC 50 // VOL DATA // LBL PAYROLL // LFD PAYROLL 
// DVC 130 // VOL TRACE1 // EXT ST,C,®,CYL,75 

// LBL IMS.TRACE // LED TRCFILE 

// DVC 131 // VOL TRACE2 // EXT ST,C,,CYL,75 

// LBL IMS.TRACE // LED TRCFILE 

// DVC 132 // VOL TRACE3 // EXT ST,C,@,CYL,75 

// LBL IMS.TRACE // LFD TRCFILE 

// EXEC ZS$IMS,,1 

// PARAM STARTUP=COLD 

/& 

// FIN 


This example executes the single-thread IMS load module, ZS$IMS, with a cold 
start. This allows terminal operators to display the last valid output message but 
does not perform file rollback. 


Three diskette volumes (available only in System 80) are allocated for the trace file. 
Because all volumes must be online at once, each volume requires a separate 
device assignment set. The LBL names and LFD names must be same for all 
volumes. 


The NAMEREC, AUDCONF, and ICAM files are on SYSRES, and the IMS load 


module, ZS$IMS, is also stored on SYSRES. Data files are on a separate disk 
volume. 
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Example 4 - Executing IMS with DEBUG parameter to locate cause of problems 


// JOB SOLVE, ,COOO,,4 

// DVC 20 =// LFD PRNTR 

// OPTION DUMP 

// DVC 5@ // VOL DISKO1 // LBL NAMEREC // LFD NAMEREC 

// DVC 50 // VOL DISKO1 // LBL AUDFILE // LFD AUDFILE 

// DVC 50 // VOL DISKO1 // LBL CONDATA // LFD CONDATA 

// DVC 50 // VOL DISKO1 // LBL TCIDTF // LFD TCIDTF 

// DVC 90 // VOL TAPEO1,TAPE@2,TAPE@3 // LBL TRACE, TAPEO1 
// LED TRCFILE,, EXTEND 

// DVC 51 // VOL DISK®2 // LBL DATAFL1 // LFD DATAFL1 

// DVC 51 // VOL DISKO2 // LBL DATAFL2 // LFD DATAFL2 

// DVC 51 // VOL DISKO2 // LBL DATAFL3 // LFD DATAFL3 

// DVC 51. // VOL DISK®@2 // LBL SCRFORMAT // LFD TCO1FMTF 
// EXEC LDIMS,,1 

// PARAM DEBUG=YES 

/& 

// FIN 


This example executes an IMS load module called LDIMS. The DEBUG=YES 
parameter tells the system to keep track of IMS status and terminal status. 


When you request a dump, it will include the status information. 


5.3.3. Modifying Action Programs in the LDPFILE 
You can make changes to action programs in the LDPFILE while IMS is running. 


To replace an action program load module in the LDPFILE, use the ZZPCH master 
terminal command. The next time a transaction calls on the action program after you 
issue ZZPCH, IMS loads the new version from the LOAD library and copies it to 
LDPFILE. The ZZPCH command is described in the IMS terminal users guide, UP-9208 
(current version). 


Before issuing ZZPCH, you must replace the action program in the LOAD library by 
recompiling and relinking or by applying a patch (COR). Do not use ALTER job control 
statements. Insert the following statement in the device assignment for the LOAD file in 
the job control stream for the compile and link or the COR stream: 


// DD ACCESS=EXCR 


5.4. TERMINATING THE IMS SESSION 


IMS is terminated by either of two commands from the master terminal: ZZSHD 
(shutdown) and ZZHLT (halt). These commands may also be entered from the system 


console or master workstation if OPCOM=YES is specified in the configurator OPTIONS 
section. 
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m= The ZZSHD master terminal command directs an orderly shutdown of the IMS 
session. 


Format: 


ZZSHD[nn] 


where: 


nn 
Specifies the number of minutes the ongoing transactions are permitted to 
continue processing. The maximum allowable time is 99 minutes for both 
single-thread and multithread IMS. The default shutdown timeout is three 
minutes in single-thread IMS and five times the configured time-out value in 
multithread IMS. 


When ZZSHD is entered, no further transactions are accepted from any of the 
terminals in the IMS network. A terminal operator attempting to enter a transaction 
receives the message 


SHUTDOWN IN PROGRESS 


Ongoing transactions are permitted to continue processing until the shutdown time 
has elapsed. Transactions not completed after this interval are canceled. 


When no transactions are active, all files are closed, communications lines are 
deactivated, and IMS terminates normally. 


= The ZZHLT master terminal command is intended for an emergency termination of 
the IMS session. When ZZHLT is entered, no further transactions are permitted, 
any transactions in progress are immediately aborted, all files are closed, the 
communications lines are deactivated, and IMS terminates with a main storage 
dump. File recovery is generally required after this type of termination, using either 
the offline recovery utility ZC#TRC or the warm restart option at start-up of the 
next online IMS session. 
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6. Batch Processing of 
Transactions 


6.1. PURPOSE AND USES OF BATCH TRANSACTION PROCESSING 


The batch processor is an optional component of IMS that can be added to any 
single-thread or multithread configuration having adequate main storage and other 
resources. You include batch transaction processing by specifying the BATCH parameter 
in the NETWORK section of the configurator. The batch processor enables you to input 
transactions in card format, instead of through a display terminal; its output is directed 
to the printer or a printer file. Batched transactions can be processed online (that is, 
concurrently with routine production operations involving the normal _ terminal 
communications network) or offline, when no terminal network need be active. 


You can submit transactions to the batch processor either from card images filed in 
disk source modules or from card images included as embedded data in the job control 
stream at IMS startup. In neither case do you need to allocate a card reader to the IMS 
job. 


Some important uses of batch transaction processing are: 


s to print a file at the end of a day’s production. A data base administrator, for 
example, might need to review a file in detail after massive update activity 


= to obtain a hard-copy listing of the data contained in a defined file or subfile - an 
activity that is not practical in normal operations from a display terminal 


m™ to test new UNIQUE-based file query and update dialogs, designed for routine use 
at production terminals 


= to test new _ user-written action programs that your operators initiate as 
transactions during normal production 


Printed output listed by the batch processor reproduces all input and output messages, 
as well as unsolicited output, and thus provides you with a permanent hard-copy record 
of each transaction. 


Y 
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6.2. PROCESSING AND OUTPUT 





Batched transactions are processed as if they had originated from actual terminals; the 
batch processor responds to one or more pseudoterminals created by the IMS 
configurator and lists output on a print file that is assigned to each pseudoterminal. This 
output is a step-by-step record of each transaction initiated. 


Immediately after each input message, the batch processor prints the output message 
issued by the action program - with the exception of immediate or delayed internal 
succession. All input messages and output messages relating to one _ batch 
pseudoterminal are listed in the same print file and are not mixed with messages from 
any other pseudoterminal. 


For UNIQUE dialogs initiated as batch transactions, the batch transaction processor lists 
what is normally seen as output by the terminal operator; formatted as it would appear 
on the remote terminal. In this case, each input message is printed above the output 
message response and starts in column 1. The start-of-entry character and the cursor 
are not represented. Terminal diagnostic and error messages are included in the output 
listing. 


Figure 6-1 illustrates an output listing created by the batch transaction processor for a 
UNIQUE dialog that opens a defined file and lists its contents. The input messages 
include an OPEN, a LIST, six MORE LIST commands, and a CLOSE. 


The output message that follows the **IMS READY** output message contains the 
name of the source input module, BATCHIN, and the name of the file, IN, on which it 
resides (specified in the PARAM IN statement). Automatic status messages — INPUT IN 
PROCESS, INPUT IN QUEUE, and ROLLBACK IN PROCESS - are never sent to a batch 
pseudoterminal. 


The first input message, OPEN CUSTOMR, initiates the UNIQUE transaction; its 
response is the OPEN COMPLETE output message, normally returned to the originating 
terminal. The output of the LIST command is the first screenful of data records from the 
defined file, CUSTOMR; the next five MORE LIST commands cause the rest of the file to 
be displayed. The END LIST response (above the sixth group of records) indicates that 
all records in the file have been displayed. The next MORE LIST command, therefore, 
produces the ILLEGAL MORE COMMAND message, and the CLOSE command is 
followed by the routine CLOSE COMPLETE output message. 


For readability of the output listing, the input messages shown in Figure 6-1 are 
punched beginning in column 10. This is feasible because they are all UNIQUE 
commands,. and UNIQUE allows this measure of free-form input. Normally, input 
messages begin in column 1. 


In normal nonbatch operations, when a user-written action program terminates in 
delayed internal succession, the terminal operator does not receive a message. The 
message that would otherwise be output is queued by IMS as input to the succeeding 
action and not displayed. For immediate internal succession, no message is sent to the 
operator or is queued. Instead, IMS makes the input and output message areas in main 
storage available to the successor action program. 
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ee ImS READY ee 


// PARAM IN@SBATCHIN/IN 


READING SOURCE MODULE BaTCHIN FROm FILE IN 


OPEN 


Cust=10 
BALANCE*DUE 
AA0DAD 
BRATL 
CALFS 


CL3K0 


Cust-10 
BALANCE =DUE 


CROHA 
Culpa 
DES 


FAILA 


CusT-10 
BALANCE DUE 


HA6FR 
JO2wC 
LA7HB 


LO2BR 


OPEN CUSTOMR 


COMPLETE 78/04/07 


LIST 


NAME 

DUFeIN@VaALUE 
ANY BUM 

0.00 ne00 
BRANNON'S BAn 

0.00 ne00 
CARRIAGE TAVERN 

0.00 n200 
CLOVER LEAF 


0.00 neOU 


MORE LIST 


NAME 

DUE*IN@VaLUE 
CREST PUB 

0.00 neOU 
CUMBERLAND C; UB 

0.00 ne00 
DEW DROP INN 

76.25 neOU 

FARRAH*S DEN 


0.00 e000 


MORE LIST 


NAME 

DUE@IN@* VALUE! 
HANOVER HOUSE 

0.00 7200 
JOCKEYS JOIN? 

0.nog 79200 
LAST CHANCE sALOON 

0.00 ye00 
LOGAN LIQUORS 

0.00 ne00 


Figure 6-1. 
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ADDRESS 
YTO=}VOLUME 
BOWERY 
0-00 
B& TUMBLE LA&Ae 
0.00 
137 ELM ST 
35 MEADOW DRe 
1.896424 


ADDRESS 
YTD}VOLUME 

& HIGHLAND ave 
0.990 
BAY AvVEe 
0.00 
13 NITEFALL ST 

76025 

16 LION ALLEY 
243019 


111 


ADDRESS 
YTN=VOLUME 
6& FOUNTAIN RN 
0.00 
20 WINNER CIRe 
0-00 
HOPE BLVDe 
0.00 
BARREL ROAN 
9.00 


MORE 
CITY=STATE 
NEW YORK oteYeo 
PFEFMBROKE, PAe 
POPULAR, NeJe 


PASTURE, PAe 


MORE 
CITY=STATE 


CREST CITY, PA 
PORTSIDE, NeJe 


LIGHTHOUSF, PA 


HILLSIDE, PA 


MORE 
CITY=STATEF 


GRAFTON, “eJe 
STRAITAWAY, PA 


GOINGVILLF. PA 


PA. 


POTTSBURG, 
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ILLEGAL MORE 


cL 


Je 


MORE LIST 


CuST=1D NAME 
BALANCE “QUE 
Lo2sc 


OUE*IN@VaLUE 
LOST CLIPPER 
0.90 
PERRY*S PUB 
0.00 
RED LANTERN — 
75.35 n.e00 
RITTER*S ROOST 
0,00 neOU 


ne00 
PEIPS 


ned0 


REIPA 


RI4cb 


MORE LIST 


CUST*1D NAME 
BALANCEpue 
RoO1IcS 


DUE* IN VALUE 
ROYAL NIGHTC; UB 

89.60 neOQ0 
SHAMROCK PALACE 

0.00 7-00 
SUPPER CLUB 

0.090 neOuU 
TOWNHOUSE CAFE 

0.00 neOV0 


SHICA 
SUSMH 


TOIFR 


MORE LIST 


CUST*ID NAME 
BALANCE CUE 
TR2HS 


DUE*INeVaLUE 
TRYTON TOWER 
25.83 neO0 
WOODEN NICKE, 
0.00 n.00 

YOUR DEMISE 
0eno 

HOT SHOT 
0.00 


WO9PRL 
YOIGA 


1200 
Yyoyy 


1200) 


MORE LIST 


COMMAND 


CLOSE CUSTOMR 


OSE COMPLETE 78/04/07 
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ADORESS 
YTD=VOLUME 
25 SAIL CIRCLE 
0-00 
162 PLANK STe 
0.00 
15 BACK ALLEY 
75.35 


46 CHICKEN Lie 


0.U0 


ADORESS 
YTD-VOLUME 
147 CASTLE STe 
R9,40 
121 CLANCY AVE 
0e90 
S57 MAIN HWwYe 
0.00 
19 FRENCH RDe 
0.00 


ADDRESS 
YTD=-VOLUME 
238 HIGH ST. 
75283 
93 BUFFALO LAe 
0.00 
REST AVE. 
0.00 
JOLLY POAD 
0.00 


100 


GQR317532 


MORE 
CITY=STATF 


HARBOR»: NeJe 
PERRYVILLF, PA 
LEGALTOWN, Nev 


BARNYARD, Phe 


MORE 
CITY@=STATE 
BLUFBLOOD, PA. 
IPISHTOWN, PA, 
OVERTON, 


NeJTe 


SPURNRURG, PA. 


END 
CITY=STATE 


TINKERTOW, PA 
MINTBURG, PAo 
BNOTHILL» MDe 


Rt UF BELL PAs 


ERROR LIST 
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In batch operations, the message is not listed as an output or an input message. With 
immediate or delayed internal succession, the next message the batch transaction 
processor lists is the output message from the succeeding action. 


Unsolicited output can be generated in any online batch-initiated transaction. This is the 
result of issuing the SEND function call in a user-written action program or including a 
SWTCH transaction in your input. Unsolicited output is not supported in offline mode. In 
the online batch mode, unsolicited output can be routed to one or more online active 
terminals. 


Unsolicited output destined for another batch pseudoterminal is not supported. 
Unsolicited output addressed to the originating pseudoterminal is listed on its own print 
file. An online terminal must not send unsolicited output to a batch pseudoterminal. 


Transaction types processed in batch mode, online or offline, include: 


m UNIQUE dialogs - Initiated by the OPEN command and containing any UNIQUE 
commands 


m= Other transactions - Initiated by a transaction code (typically, these activate 
user-written action programs) 


m= The standard terminal commands - ZZTMD and ZZNRM. (The ZZHLD, ZZRDY, 
ZZCNC, and ZZRSD terminal commands have no useful role in a_ batch 
environment.) 


a SWTCH transaction - For terminal-to-terminal communication 


Batch input messages must not include any master terminal commands because batch 
pseudoterminals may not be designated as master terminals. Distributed data processing 
is not supported in batch mode. A batch pseudoterminal cannot route transactions to a 
remote IMS system using operator, directory, or program routing. 


6.3. CONTROLLING BATCH TRANSACTION PROCESSING 


You set the stage for batch transaction processing when you specify batch processing 
in the IMS configuration. You must also make certain modifications to the IMS execution 
run stream. 


Batch transactions can be processed in offline or online modes. Control of offline 
processing is essentially a matter of the order in which source input is presented in the 
control stream (6.5). The ZZBTH master terminal command gives the online user 
considerable flexibility in determining when batch processing is to begin and end and in 
specifying which input is to be processed and in what order (6.6). 


6.3.1. Effect of IMS Configuration Options 


The BATCH parameter in the NETWORK section of your input to the IMS configurator 
adds the batch processing modules to your IMS system. 
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When you use this parameter, the IMS configurator generates one or more batch 
pseudoterminals. If you specify BATCH=YES, one pseudoterminal is generated and 
assigned the terminal-id, BTH1. When you specify BATCH=n, the configurator 
generates the number of pseudoterminals designated by n; the terminal ids are 
BTH1,...,BTH4. 


In a single-thread IMS system, you process only one batch input source module or one 
embedded data set at a time, so the specifications BATCH=YES and BATCH=1 are 
equally valid. In a multithread IMS configuration, although you still process only one 
embedded data set at a time, you can process up to the maximum number (n) of batch 
input source modules simultaneously. This means that if you specified BATCH=3 to the 
IMS configurator, you can process up to three source modules at one time, or one 
embedded data set and up to two source modules. In online mode, you initiate 
transactions by issuing the ZZBTH master terminal command. Again, the number of 
transactions that can be active simultaneously is limited by the maximum specified in 
the BATCH parameter. (The ZZBTH command is described in 6.6.1.) 


6.3.2. IMS Control Streams for Batch Processing 

In coding the IMS execution run stream for batch transactions you must: 
1. assign source module input files; 

2. assign printer files; 


3. insert PARAM statements to control the batch processor (these must always follow 
any other PARAM statements present); and 


4. optionally, embed sets of input source data in the control stream. 


6.3.2.1. Assigning Source Module Input Files 


Unless all batched transactions are to be represented by data sets embedded in the 
control stream, you must name and create one or more source modules containing the 
card images of your input messages, and place these modules in a disk library file. Each 
input disk file contains several modules. In the control stream, you must assign these 
source module input files to the IMS execution job using OS/3 job control conventions. 
The LFD-names of these input files are used in the PARAM IN statements. 


6.3.2.2. Assigning Print Files to Batch Pseudoterminals 
A print file must be assigned to each batch pseudoterminal that the IMS configurator 


has been directed to generate by the BATCH parameter. The batch processor expects 
these LFD-names for the print files: 
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@ Terminal-id Print file LED-name 
BTH1 PRNTR1 
BTH2 PRNTR2 
BTH3 PRNTR3 
BTH4 PRNTR4 


Again, the assignment of these files follows OS/3 job control conventions. 


6.3.2.3. Initiating And Controlling Batch Processor (PARAM Statements) 


The batch processor parameter statement (PARAM BATCH) follows all other PARAM 
statements (except IN) in an IMS execution run stream. It immediately follows the EXEC 
statement if there are no other PARAM statements. The PARAM BATCH statement is 
followed by optional PARAM IN statements indicating source module input files to be 
processed (if any). BATCH and IN parameter statements are described in 5.3.1.6 and 
5.3.1.7. 


6.3.2.4. Embedding Source Data in Control Stream 


If you wish, you may embed sets of card images of input messages in the batch 

@ processor control stream, following OS/3 job control conventions. These can be 
interspersed freely among the PARAM IN statements (Figure 6-2). However, for better 
performance in multithread batch processing, you should group all embedded data sets 
last, after all your PARAM IN statements. 


6.3.2.5. Sample Control Stream 


Figure 6~2 illustrates a control stream for executing a multithread IMS system for online 
batch transaction processing. Note that the arbitrary LFD-name of the input source file 
(SRFILE), assigned in a DVC-LFD job control sequence, is repeated in the two PARAM 
IN statements later in the control stream; one PARAM IN statement calls for processing 
of transactions in a module of SRFILE named TEST. The other statement refers to a 
module in this file named PROD. This example assumes that BATCH=4 is specified in 
the NETWORK section input to the IMS configurator. (The number of printer files 
assigned to the job indicates this.) 


6.4. PREPARING TRANSACTION INPUT FOR BATCH PROCESSOR 
Input to the batch processor is in the form of card images, either filed on disk or 


included as embedded data sets in the IMS execution run stream. This makes it easier 
for you to do batch testing, as well as standard batch production runs. 
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IMSBATCH, , 36EE8 
50 // VOL 123456 NAMEREC NAMEREC 
5@ // VOL 123456 AUDFILE wana) 
5@ // VOL 123456 CONDATA CONDATA 
50 // VOL 123456 TCIOTF TCIDTF,, INIT 
50 // VOL 123456 DQFILE1 DQFILE1,, INIT ® 
50 // VOL 123456 DQFILE2 DQFILE2,, INIT 
5@ // VOL 123456 DQFILE3 DQFILE3,, INIT 
; io 


123456 LBL DQFILE4 SRFILE 


je 





DVC 2@ // LFD PRNTR1 

Dve 20 // LFD PRNTR2\ 
DVC 2@ // LFD PRNTR3 
DVC 20 // LFD PRNTR4 
OPTION DUMP 

EXEC ZQ#IMS,LOAD, 1 (6) 
PARAM START(7) 

PARAM BA=ONLINE 

PARAM IN=TEST/SRFILE 


|e 





PARAM IN=PROD/SRFILE 


ic 





NOTES: 

@) A single-thread IMS system uses the AUDCOMF file in lieu of these. 

@ Not required for offline batch mode, which does not use a terminal network. 

@ Assign user data files 

@ Assign source module input files referenced in ZZBTH master terminal commands. 

© Assign printer files; one for each batch pseudoterminal created by the configurator. Equal in number to the number 
specified in the BATCH configurator keyword. 

© The program name on the EXEC statement must match the LOADM parameter specification on the IMSCONF 
jproc at configuration. 

@ For offline mode, code this as // PARAM BA=OFFLINE. 

Batch input cards 

(©) Param IN statements, or embedded data sets, or both, are required for offine batch mode. Data sets may be freely 


interspersed among PARAM IN statements. These are optional in online batch mode and when present are 
processed through one or more ZZBTH*(,ALL) master terminal commands. If absent in online batch mode, the 
module-name, filename form of the ZZBTH command is used to specify all input source modules to be processed. 





Figure 6-2. Sample IMS Execution Run Stream for Online Batch Processing in a Multithread System 
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6.4.1. Input Message Coding 


Each input message is contained on one card or as many as 18 cards; messages are 
grouped in the same sequence as the operator would enter them at the terminal. The 
batch processor takes input message text from card image columns 1 through 71. 
(Individual messages longer than 71 characters are continued on the next card image by 
coding a nonblank character in column 72; coding on the continuation card image 
begins in column 1.) Up to 17 continuation card images are allowed, giving a maximum 
length of 1346 bytes for any one message. Columns 73 through 80 are reserved for 
sequence numbers, which are neither required nor processed. Both input message text 
and device independent control expressions (DICE) are in EBCDIC code. 


When coding UNIQUE dialogs for batch transaction processing, use the hard-copy 
format of the ADD and CHANGE commands to avoid the laborious preparation of DICE 
sequences needed for the display format. 


When coding an input message for a user action program that does not allow free-form 
placement of data characters, you must code the data in the specific card columns 
required by the program. 


The SWTCH transaction must always be coded beginning in input card column 1 
because this is the position expected by the SWTCH action program. 


Figure 6-3 illustrates a sample UNIQUE dialog transaction prepared as input for batch 
processing. It comprises 10 input messages and is followed by two SWTCH 
transactions for sending unsolicited output to active online terminals. These card images 
make an embedded data set for inclusion in the control stream. Notice that no delimiter 
is required to separate the UNIQUE dialog from the SWTCH transaction code that 
follows it (the CLOSE command serves this purpose) and that nothing is used to mark 
the beginning or end of the source module. Notice also the handling of continuation for 
the input message that contains more than 71 characters. 


6.4.2. Handling DICE Characters 


Certain user-written action programs employ DICE sequences to format output 
messages. The characters in these sequences are written as hexadecimal symbol pairs 
(using EBCDIC characters). To eliminate the requirement that the hexadecimal codes be 
multipunched, the batch processor employs a_ shift character (the 1 character, 
multipunch 11-7-8) to indicate that all EBCDIC characters following it are to be treated 
as hexadecimal digits (O-9,A-F) until another 1 character is read. Each pair of 
hexadecimal digits is converted to a single byte before being passed to the batch 
processor. Two symbols in succession are converted to a single 1. For example, the 
following EBCDIC sequence in an input message: 


1190409000 7 YES 7 05711 


is transmitted to the processor as: 


119 1OL4IOLOLOIOLETB 


UP-8364 Rev. 7 SPERRY UNIVAC OS/3 6-10 
IMS SYSTEM SUPPORT FUNCTIONS 


NOTE: 


The first four bytes are the DICE sequence for position control to new line on a CRT 
device. 


When the batch processor encounters DICE control sequences or the ESC (escape) 
character (2716) in an output message area, it strips them before printing the message. 
This corresponds to the online handling of DICE codes and hardware characters, which 
are not displayed on the terminal. An output message area could look like this: 


js fofotsJorsfotofcis][ctafcra[cia}crs|cre]sjoforsjoyolorojci7jcrs}2i7jors|cia| 
gg Nae a a! Ne piten! ater 


DICE Control Sequence Message Text Dice Control Sequence Msg. ESC HT Msg. 
Text Text 


The print lines of this message after batch processing looks as follows: 
First line: ABCDEF 
Second line: GHI 


Note the deletion of DICE control sequences and the ESC character (2716) and HT 
(horizontal tab, 0546). 


6.5. CONTROLLING BATCH PROCESSING IN OFFLINE MODE 


Because IMS executes without a communications network in offline batch mode, you 
cannot control batch processing from the master terminal. Instead, you assign batch 
input source files with statements in the IMS execution run stream. 


The BATCH=OFFLINE parameter statement is followed by IN parameter cards and/or 
embedded data sets of input card images; data sets are freely interspersed. The order 
in which these appear in the streams is the order in which the batches they represent 
are processed. The order of listed output is automatically determined by the batch 
processor. You can only indirectly control its order by the sequence in which you 
submit your input and, in a multithread IMS system, by the number of batch 
pseudoterminals you have generated with the BATCH configurator parameter. 


6.6. CONTROLLING BATCH PROCESSING IN ONLINE MODE 


IMS requires an active communications network in the online batch processing mode. 
This requirement allows you to control batch processing from the master terminal, using 
the ZZBTH master terminal command to specify which source modules are to be 
processed and when. 
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Batch processing that is conducted in online mode during normal production hours, 
when the regular operating terminals are busy, downgrades performance. For this 
reason, it is better to run online batch processing during slow periods or before 
shutdown. Or you could do online batch processing during nonproductive time, perhaps 
configuring a special network consisting of the master terminal alone. 


One factor that affects online batch performance is the number of batch modules being 
processed concurrently in a multithread IMS system. The smaller the number of 
modules, the better the performance. The maximum number of modules that can be 
processed concurrently is specified in the BATCH configurator parameter. However, the 
master terminal operator controls the number of modules that are actually submitted 
simultaneously to the batch processor (within the maximum limit) by his timing of the 
ZZBTH command. 


You assign batch input source files and printer files with job control statements in the 
IMS execution run stream. You specify PARAM BATCH=ONLINE, followed by optional 
PARAM IN statements and embedded data sets. No batch processing takes place until 
you enter the first ZZBTH master terminal command. Note that PARAM IN statements 
or embedded data are appropriate only if you use the ZZBTH *[,ALL] form of the 
ZZBTH master terminal command to control batch processing in online mode. The 
module-name, file-name form of the ZZBTH command does not take source input from 
the control stream. 


If you want to list the output printed by the batch processor before IMS terminates, the 
system console operator must call the output writer by entering PR BU; if any print files 
are ready, printing will begin immediately. The purpose of entering the BU (burst mode) 
parameter is to avoid printing the IMS job’s log file first, as would otherwise happen. If 
you configure console support, (OPCOM=YES in the OPTIONS section), you can send a 
message to the console operator using the SWTCH transaction. 


If only one printer is available, you should configure a spooling supervisor at system 
installation time. (This is necessary because a nonspooling supervisor prints the output 
as soon as it is generated by the batch processor.) 


6.6.1. ZZBTH Master Terminal Command 


You enter the ZZBTH terminal command at the master terminal to initiate and control 
the batch transaction processor in online mode. Parameters are available to specify the 
source of input messages for each execution of the command, to control sequential 
progress through control stream input, and to terminate, suspend, or resume the batch 
transaction processing currently taking place. 


Format: 


ZZBTH/module-name, filename 
*(, ALL] 
CANCEL 
PAUSE 
RESUME 
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where: 





module-name 
Is a one- to eight-character name of the source module that contains the card 
images of input messages to be processed by the batch transaction processor. 
When this module-name, filename form of the ZZBTH command is used, the 
batch processor locates the input source module in the file named by the 
second parameter, filename. 


filename 
Is a one- to eight-character name of the file on which the foregoing source 
module resides. The filename parameter must match the LFD-name specified in 
a job control statement assigning the file to the current execution of IMS. 


Specifies that the source of input messages for this execution of the ZZBTH 
command is the next PARAM IN statement or the next set of embedded data 
in the IMS job control stream. When this is the first ZZBTH * command for the 
current execution of IMS, the batch processor uses the first PARAM IN 
statement or embedded data set it encounters in the job stream. If this is not 
the first ZZBTH * command in the job stream, the batch processor uses the 
next PARAM IN statement or embedded data set that follows the input source 
used by the preceding ZZBTH * command. 





ALL 

Specifies that the entire run stream will be processed, starting with the next 
source of input messages (represented by the * parameter specified with this 
execution of the ZZBTH * command). If the optional ALL parameter is omitted, 
processing of the run stream input stops when the next PARAM IN card or set 
of embedded data is processed. If a subsequent source module is represented 
in the run stream, you must enter another ZZBTH * [ALL] command to process 
it. 


CANCEL 
Specifies that all batch transaction processing currently in progress must 
terminate. Processing of each transaction ceases after the current output 
message has been sent to the print file, and the print file is closed. File 
modifications made since the beginning of the current transaction are not rolled 
back. The batch processor substitutes a ZZCNC terminal input command for 
the next expected input message. 


PAUSE 
Specifies that all batch transaction processing currently in progress must be 
suspended. Processing of each transaction ceases after the current output 
message has been sent to the print file, but the print file is not closed. 


RESUME 


Specifies that all batch processing temporarily suspended by the preceding 
ZZBTH PAUSE command must resume. 
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6.6.2. Initiating Online Batch Processing 


When you enter the ZZBTH command at the master terminal and the batch processor 
recognizes batch input, it sends the message BATCH INITIATED to the master terminal, 
and processing begins. 


With single-thread IMS, you can enter only one ZZBTH command at a time; the 
transaction it requests must be completed before you enter another ZZBTH command. 
Conversely, in a multithread IMS system, several ZZBTH commands can be processed 
simultaneously, up to the maximum specified by the BATCH configurator parameter. 


If the master terminal operator attempts to enter a ZZBTH command in excess of the 
maximum number of batch modules that can be processed concurrently (or a 
single-thread operator enters a second command before the processing of the current 
command is finished), IMS responds with a diagnostic message: 


TOO MANY ZZBTH COMMANDS ENTERED - COMMAND IGNORED 


6.6.3. Tracking Progress of Batch Processing 
To determine when a batch run is complete or to keep track of the processing of batch 
modules, the master terminal operator, at any time, can enter the ZZTCT master 
terminal command to access the terminal control table generated for any batch 
pseudoterminal, and specify the batch terminal-id desired (BTH1,...,BTH4). The ZZTCT 
command provides the master terminal with a report of the activity outstanding at the 
specified terminal. 
Format: 

ZZTCT terminal-id 


where: 


terminal-id 
Is the configured symbolic identification of the specified terminal. 


In response to the ZZTCT terminal command, IMS sends this message to the master 
terminal: 


STATUS OF terminal-id{UP \:nnnn MSG;nnnn TRAN; nnnn TRM CMD;ALT=name 


DWN 
HLD 
TMD 
where: 
nnnn 


Is the number of messages, transactions, or terminal commands. 
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6.6.4. Resuming Batch Processing Once Terminated 


The ZZBTH CANCEL command terminates only the batch transactions currently being 
processed. The transaction processing that has been completed is listed. Nothing 
prevents you from reprocessing the same modules or processing other source modules. 
You can continue by issuing the appropriate ZZBTH command after having received a 
response to the ZZBTH CANCEL command. The response to the ZZBTH CANCEL 
command is this message: 


BATCH PROCESSING CANCELLED 


The effect of issuing a ZZBTH *[,ALL] command after you have issued a ZZBTH 
CANCEL command is to read the control stream at the next data set present. If you 
issue the ZZBTH module-name, filename form of the command and specify a module 
whose processing was interrupted by the ZZBTH CANCEL command, that module will 
be processed from its beginning, not from the point where processing stopped. 


6.6.5. Repetitive Use of Batch Mode 


There is no feature in the batch transaction processor that checks whether your files 
have been processed by the same input - in fact, batch mode facilitates reprocessing 
with repetitive use of the same input. This enables you to use the same program at the 
end of each day to list the state of your files and to review the day’s activity. 


6.7. CONTINUOUS OUTPUT CONSIDERATIONS 


Output delivery notification to a batch pseudoterminal is always considered successful 
by the batch transaction processor. A program using output-for-input queueing can be 
testing in batch mode, but it is not reasonable to perform continuous output by this 
means in a batch production run. 


6.8. BATCH PROCESSOR DIAGNOSTIC MESSAGES 


Besides the diagnostic and error messages IMS sends to the operator at a production 
terminal (which the batch processor includes in the output listing for each batch 
pseudoterminal), the batch processor generates a set of its own messages. It sends 
these to the master terminal or includes them in the output listing for the batch 
pseudoterminal, as is appropriate. Table F-3 lists the text of these messages, describes 
their causes, and indicates the corrective action you can take. 
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6.9. RECOVERY CONSIDERATIONS 


To recover batch processing after either a cold or warm restart, you send a DLMSG 
input transaction (in card image form) to the batch processor. You must supply one 
card image for each batch terminal. For single-thread IMS, only one card is required. 
The printed output from the DLMSG transaction indicates how much of the input batch 
module was processed before the system aborted. You can then reconstruct the batch 
input card deck or use the librarian to edit a source library input message module. 


An example of a warm restart batch input for a single-thread batch system is: 
/$ 
DLMSG BTH1 
/* 


For a warm restart, the before images for the files are restored at the start of the last 
transaction completed. 
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7. File Recovery 


7.1. RECOVERY FUNCTIONS 


Preserving the integrity of your data base is a vital consideration when you are updating 
your files. IMS provides a complete file recovery system that operates in both online 
and offline environments to simplify the protection of your DAM, ISAM, and MIRAM 
files. 


Online recovery is automatic when you specify file updating in your configuration (unless 
you configure LOCK=UP in the FILE section). Every time a transaction terminates 
abnormally, IMS rolls back your files to the start of the transaction or to the last 
rollback point specified in the action program performing the transaction. IMS also rolls 
back your files at system start-up when you specify a warm restart; in this case, all 
transactions that were active at the time of IMS termination are rolled back. 


Offline recovery is performed by an IMS utility program, ZC#TRC, after termination of 
online processing. The offline recovery program restores files left damaged or in an 
inconsistent state as a result of a system failure or any other reason. A second offline 
utility, ZC#TCP, copies and closes a tape trace file left open by system failure. Offline 
recovery is available only when you specify the RECOVERY parameter in your 
configuration. 


Both online and offline recovery functions assume that your files are not updated by 
non-IMS programs during the IMS session. Updating by other programs would 
compromise the recovery process. To avoid this possibility, you must include file 
locking capability in your control system at system generation time (Series 90 only). 
You can choose from several kinds of access rights by specifying the ACCESS data 
management parameter in the FILE section of the configuration. If you omit the ACCESS 
parameter, the configurator default specification prevents other programs from updating 
your files. 


During online processing, IMS creates three internal files (if configured) that aid in 
recovery: 


1. the audit file (AUDFILE for a multithread system, AUDCONF for single-thread), used 
for online recovery; 
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2. the terminal output message file (TOMFILE), which allows terminal operators to 
determine how far rollback has gone; and 


3. the trace file (TRCFILE), used for offline recovery. 


Table 7-1 summarizes the online and offline recovery functions, the internal files used 
for each, and the configuration parameters required. 


Table 7-1. Recovery Options 


Online/ Recovery Internal Configuration 
Offline Function Files Used Parameters Required’ 


Online Roliback: Audit file (AUDCONF FUPDATE, TOMFILE 
a Online transaction for single-thread, (TOMFILE required for 
roliback AUDFILE for warm restart 
rl] Warm restart multithread) only) 


Display last effective Terminal output FUPDATE, TOMFILE 
output message (DLMSG message file 
transaction) (TOMFILE partition 

of AUDCONF or 

CONDATA file) 


Offline Utility programs: Trace file FUPDATE, RECOVERY 
a Offline recovery (TRCFILE) 
utility (ZC#TRC) 
a Tape copy routine 
(ZC#TCP) 


Recover TOMFILE in TRCFILE, TOMFILE FUPDATE, RECOVERY 
addition to data TOMFILE, TOMTRCE 
files 





*All configuration parameters listed are specified in the OPTIONS section. 


7.2. FILES CREATED FOR ONLINE AND OFFLINE RECOVERY 


7.2.1. Audit File 


The multithread AUDFILE or the single-thread AUDCONF file is a partitioned system 
access technique (SAT) disk or diskette file containing a partition for each terminal in 
your network. Before-images of updated records are written to the partition for the 
terminal originating the transaction. Each partition must be large enough to contain all 
before-images recorded between two rollback points or between a rollback point and 
transaction termination. You specify the maximum number of records to be contained in 
a partition with the AUDITNUM parameter in the configurator GENERAL section. At 
rollback points and transaction termination, the current record pointer for the active 
partition is reset to point to the first record of the partition and the records from the 
previous transaction are overwritten. If the number of before-images exceeds the 
number specified by the AUDITNUM parameter, the transaction is canceled and _ all 
updates from that transaction (or since the last rollback point) are rolled back. 
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7.2.2. Terminal Output Message File 


The terminal output message file (TOMFILE) is a partition of the single-thread AUDCONF 
file or the multithread CONDATA file. Each terminal is allocated its own record for 
output message logging. At rollback points and transaction termination, IMS records the 
contents of the action program's output message area in the TOMFILE, retaining only 
one message per terminal. The most recent output message for a terminal overlays the 
one before it. 


The terminal operator can display the most recent output message by entering the 
transaction code DLMSG. The same transaction code is automatically displayed at each 
terminal after a cold or warm restart, and the terminal operator can retrieve the last 
effective output message by pressing the TRANSMIT key. 


Terminal output messages are also recorded in the trace file if the TOMTRCE 
configurator parameter is specified. This allows the offline recovery utility to roll back 
the TOMFILE to reflect the state of your data files after recovery. 


7.2.3. Trace File 


The trace file (TRCFILE) is a disk, diskette, or magnetic tape SAT file, maintained by 
online IMS as a continuous, unblocked, sequential file. A tape trace file may have 
multiple volumes. A diskette trace file, available only in System 80, and a disk trace file 
may also have multiple volumes, but all volumes must be online at the same time. You 
can use the same trace file for more than one IMS session by specifying PARAM 
TRCFILE=CLOSE or TRCFILE=EXTEND for disk/diskette or the EXTEND parameter of 
the LFD statement in the job control stream at IMS start-up for tape. (See Figure 5-1.) 
The usual procedure is to start a new trace file each time you do a security dump of 
your data files, so that the current trace file reflects all updates entered into your files 
since the last security dump. When you use a diskette trace file, you usually start a 
new trace file for each session because space is limited to the number of diskettes you 
can have online at one time. 


The trace file contains before-images, after-images, or both, of all updated records 
(depending on your RECOVERY parameter specification at configuration), plus rollback 
and termination records. If you specified both the TOMFILE and TOMTRCE configurator 
parameters, the trace file also contains output messages generated at rollback points 
and transaction termination. 


The block size of the trace file is calculated by the configurator from the largest record 
length or block size specified in the FILE section, except that those files for which 
TRACE=NO is specified are not considered. If you specify terminal output message 
tracing, the configurator also checks the OUTSIZE specification in each of your ACTION 
sections and uses the largest of the record length or OUTSIZE specifications in your 
configuration. 


Each block of the trace file contains a 104-byte prefix area plus a before-image, 
after-image, output message, rollback point, or transaction termination record. Figure 
7-1 illustrates the layout of the prefix area, and Table 7-2 describes its contents. 
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Byte 0 1 2 3 


12 record length prefix length 
a 





20 transaction-id 
(date-time of initiation) 


24 
28 i 
trace date-time 
32 
36 initial action 
‘s ahaa 


44 current action 


program name (reserved) 
“ 


52 


fite name 
56 


60 
’ (spares) 
68 
72 


76 





record identification 
80 


84 


transaction code 
88 flag bytes 
92 (reserved for system use) 


96 (spares) 
100 


Figure 7-1. Format of Prefix Area of Records in the Trace File 
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Table 7-2. Contents of Prefix Area for Trace File Records 


Field Name Code Description 


ZF#VRLEN | Total length Total length of block: 104-byte prefix plus length of record 
or output Sa ae 
ZFHSTYP System type | 4 | escorc | | escoic | Constant: | for IMS 


ZFHACM Access method Hexadecimal | D for MIRAM (DTF mode) 
| for ISAM 
ZFHRTYP Record type EBCDIC 
ROLLBP Rollback point 
TERMIN Transaction termination record 


M for MIRAM (CDM mode) 
R for DAM (relative record) 

| zearaL | Record length 12-13 | Length of record or output message, in bytes | of record or output message, in bytes 

ZFHTPL Prefix length 14-15 Binary 104 bytes + key length (indexed files) or 8 bytes (nonin- 
dexed files) 

ZFHTTMID | Terminal-id 16-19 Configured identification of terminal originating transac- 
tion 

ZF#TTRID Transaction-id 20-27 Date-time of initiation of current transaction, in the form: 
yy-dd-mm-hh-mm-ss 

ZFHTTIME | Trace date-time 28-35 Date-time of writing this record to the trace file, in the 
same format as transaction-id 

ZFHNAPI Initial action 36-41 Configured name of first action program called for this 

program name transaction 


ZFHNAPC Current action 44-49 
program name 











BEFORE Before-image 
AFTERA After-image 
OUTPUT Output message 





























eS name of action program currently active 


Configured name of the conventional file accessed by 


a A OS 
current action program, left-justified. For terminal output 


ZF#TFNM File name 52-59 EBCDIC 
messages, this field contains the name TOMFILE. 


record number of the record prefixed, in binary, right- 


ZF#TKLID 76-83 
justified. 

















Record 
identification 


For an indexed file, bytes 76-79 contain the key length, 
and bytes 80-83 the key location, measured in hexadeci- 
mal bytes. 





For a nonindexed file, bytes 76-83 contain the relative 
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7.3. ONLINE RECOVERY 


When you are updating your data files, IMS writes a before-image of each updated 
record to the audit file (unless you have specified LOCK=UP in the configurator FILE 
section). When a transaction is abnormally terminated, or at system start-up when 
warm restart is specified, IMS uses these images to roll back the updated records to 
the beginning of the transaction or to the last rollback point. The online recovery facility 
is automatically included in your configured IMS system when you specify file updating 
(FUPDATE parameter). 


If you specify TOMFILE=YES in the configurator OPTIONS section, IMS copies the 
contents of the action program's output message area to the terminal output message 
file (TOMFILE) at each rollback point and at transaction termination. When data files are 
rolled back, the terminal operator can determine how far rollback has gone by entering 
the transaction code DLMSG to display the last effective output message from the 
TOMFILE. 


7.3.1. Online Transaction Rollback 


When a transaction terminates abnormally, the rollback program rolls back data files for 
which you have configured LOCK=TR to the state they were in before the transaction 
that failed or to the last rollback point specified by your action program or UNIQUE. 
More information about online transaction rollback is available in the IMS action 
programming manuals. 


7.3.2. Warm Restart 


Warm restart is actually a multiple online transaction rollback. When you include the 
PARAM STARTUP=WARM statement in the job control stream at IMS start-up, IMS 
rolls back all updates performed during transactions that were active at the time of IMS 
termination or OS/3 system failure. Transactions are considered active whenever the 
last record written to the audit file for a transaction is not a termination or rollback 
record. To use the warm restart facility, you must specify TOMFILE=YES to the 
configurator. 


NOTE: 


Warm restart is supported for MIRAM files only if they were created with the data 
management recovery option (RECV=YES of the DD job control statement). Refer to 
the current version of the basic data management user guide, UP-8068, or the 
consolidated data management concepts and facilities, UP-8825. 
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7.4. OFFLINE RECOVERY 


The purpose of offline recovery is to restore data files left damaged or in an 
inconsistent state after IMS termination or system failure. The ZC#TRC offline recovery 
program can perform three different types of file recovery: 


1. forward recovery (required if a portion of your data files is destroyed); 


2. backward recovery (used when your data files are accessible but in an inconsistent 
state); and 


3. quick recovery (used when transactions are left incomplete because of system 
failure or emergency IMS termination). 


During online operations, IMS writes before-images, after-images, or both (depending on 
your RECOVERY configurator parameter specification), of updated records, plus rollback 
points and termination records, to a tape, disk or diskette trace file. It also copies 
output messages generated at rollback points and transaction termination to the trace 
file, if you specify both TOMFILE and TOMTRCE to the configurator. 


The offline recovery program uses the information in the trace file to restore your data 
files and to roll back the TOMFILE to reflect the state of your data base after recovery. 
The program can also be used to print out the contents of the trace file, giving you a 
listing of all the updates recorded during an IMS session. 


If your trace file is on magnetic tape and is left open because of system failure, you 
must copy it onto another tape volume and close it properly, using the ZC#TCP tape 
copy routine, before it can be used for offline recovery. 


7.4.1. Types of Recovery 


The type of file recovery required depends on the state your data files are in at IMS 
termination or system failure. When any portion of your data files is destroyed, you 
should use the forward recovery procedure. When your files are accessible but in an 
invalid state, you should use backward recovery. When only the transactions that were 
active at the time of IMS termination need to be rolled back, you should use quick 
recovery. You specify the type of file recovery to the ZC#TRC utility with the 
RECOVERY-TYPE parameter. 


7.4.1.1. Forward Recovery 


Forward recovery is used for reconstruction of damaged files. Because of this, you need 
a copy of these files that you previously created in a security dump or dump/restore 
procedure. Refer to the OS/3 system service programs (SSP) user guide, UP-8062 
(current version) for information on creating backup files. 
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in forward recovery, the ZC#TRC utility updates your backup files to the date-time you 
specify or, if you do not specify a date-time, records all completed transactions. To 
update your backup files, ZC#TRC uses the after-images recorded in the trace file; these 
after-images are recorded in the trace file only when you specify RECOVERY=AFT or 
RECOVERY =ALL in your configuration. 


Forward recovery is a 2-pass procedure. During the first pass, the program reads the 
trace file to determine which transactions were active against the specified user data 
files at the specified date-time or (if no date-time is specified) at the end of the trace 
file. During its second pass, the program applies to these files all after-images recorded 
in the trace file for completed transactions. If the ZZCLS and ZZOPN master terminal 
commands were issued during the IMS session for any of your files, you should include 
the PFILES parameter. For the files you specify, the recovery program applies only the 
after-images recorded since the last valid ZZOPN master terminal command was issued. 
For incomplete transactions, any after-images traced between the start-of-transaction 
record and the last rollback point are applied. If you specify that the TOMFILE is to be 
recovered in addition to your data files, ZC#TRC copies to the TOMFILE the last output 
message recorded in the trace file for each terminal up to the recovery point. 


In this type of recovery, ZC#TRC reads the trace file in the forward direction during 
both passes. If you have a multivolume magnetic tape trace file, you must remount the 
first volume at the end of the first pass. 


7.4.1.2. Backward Recovery 


Backward recovery should be used when your data files are accessible but, for some 
reason, some of the updates recorded in them are invalid. If you can pinpoint a date 
and time at which your files were in a valid state, you should specify the DATE-TIME 
parameter; only those updates recorded after that point are rolled back. When you 
include the PFILES parameter, only those updates recorded since the last ZZOPN 
command are rolled back for the files you indicate. If you omit both DATE-TIME and 
PFILES, all updates since the start of the trace file are rolled back. 


ZC#TRC uses the before-images recorded in the trace file for backward recovery; to use 
this feature, you must specify RECOVERY =BEF or RECOVERY=ALL to the configurator. 


ZC#TRC uses two different procedures for backward recovery, depending on whether 
or not you specify the DATE-TIME parameter: 


m DATE-TIME specified: 2-pass procedure 


During the first pass, the recovery program reads the trace file in the forward 
direction to find transactions active against the specified data files at the date-time 
indicated. In the second pass, ZC#TRC reads the trace file in the backward 
direction and applies all before-images recorded from the end of the trace file back 
to the last rollback point or start-of-transaction record before the specified 
date-time. For files specified on the PFILES parameter, before-images are applied 
back to the last ZZOPN command, if later than the date-time specified. 
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When you have a multivolume magnetic tape trace file, you must mount the 
volumes sequentially in the forward direction for the first pass and then in the 
backward direction for the second pass. 


a DATE-TIME not specified: single-pass procedure 


When you do not specify the date and time, ZC#TRC makes only one pass, 
reading the trace file in the backward direction. All before-images are applied to the 
specified data files back to the beginning of the trace file. For files specified on the 
PFILES parameter, before-images are applied back to the last ZZOPN command. 


If you have a multivolume magnetic tape trace file, volumes must be mounted in 
the backward direction, starting at the end of the last volume. 


If you specify the DATE-TIME parameter, you can recover the TOMEFILE in addition to 
your data files. ZC#TRC copies to the TOMFILE the output message recorded in the 
trace file for each terminal at the last rollback point or transaction termination before the 
specified date-time. 


NOTE: 


When the beginning of a magnetic tape trace file volume is read during the execution of 
backward recovery, the following message is displayed on the system console: 


DM22 TRCFILE physical unit number 
HARDWARE ERROR CHECK ERROR STATUS/SEN 


Ignore this message and respond to the next message, which tells you to mount the 
next volume. 


7.4.1.3. Quick Recovery 


Quick recovery, a 2-pass procedure, may be used in the case of system failure or 
emergency IMS termination. When the ZZHLT master terminal command is issued, or 
when the system fails, the transactions that are in process cannot be completed. Quick 
recovery rolls back all transactions active at the time of termination. The DATE-TIME 
parameter is never specified. 


During the first pass, the recovery program scans the trace file in the forward direction 
to determine which transactions were active against the specified files at termination. In 
the second pass, ZC#TRC reads the trace file in the backward direction and applies 
before-images to the specified files until a rollback point or a start-of-transaction record 
is reached for all the transactions active at the end of the trace file. For files specified 
on the PFILES parameter, recovery stops at the last ZZOPN command, if reached before 
a rollback point or start-of-transaction record. To use the quick recovery feature, you 
must specify RECOVERY =BEF or RECOVERY=ALL to the configurator. 
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Magnetic tape trace file volumes must be mounted sequentially in the forward direction 
for the first pass and then in the backward direction for the second pass. 


Recovery of the TOMFILE is not necessary, because the TOMFILE already contains the 
output message associated with the last rollback point or transaction termination before 
system failure. 

An alternate way of recovering your data files after system failure or emergency 
termination is to use the warm restart feature at initiation of your next online IMS 
session. 

NOTE: 

Quick recovery is supported for MIRAM files only if they were created with the data 
management recovery option (RECV=YES of the DD job control statement). Refer to 


the current version of the basic data management user guide, UP-8068 or the 
consolidated data management concepts and facilities, UP-8825. 


7.4.2. Running Offline Recovery 


7.4.2.1. Linking the Offline Recovery Program 


Before you can use the offline recovery utility, ZC#TRC, you must link the recovery 
object module, ZE#OLREC, with: 


u the object module containing your configuration control tables and data file DTFs or 
CDIB/RIBs; and 


= ~=the appropriate data management |/O modules for: 

- your data files; 

- the print file; and 

- the trace file, if it is on tape. 
The ZE#OLREC module is stored in the $Y$OBJ library file on SYSRES or OS/3REL, 
depending on the SYSGEN option you selected (1.3), unless you have copied it onto a 


user library. Data management modules are in $Y$OBJ on SYSRES. 


The configuration object module name is in the form: 


zS#IOnnn - for single-thread DTF system 
ZQ#10nnn - for multithread DTF system 
ZS$10nnn - for single-thread CDM system 
ZQ$10nnn - for multithread CDM system 


where nnn is the configuration identifier (4.3.1.2). 
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This module is stored in the library specified with the LIBO parameter of the IMSCONF 
jproc at configuration; the default library is $Y$OBJ on OS/3REL (Series 90) or SYSRES 
(System 80). If you use the IMSGEN option at SYSGEN and the LIBO default at 
configuration, the recovery and configuration object modules are on OS/3REL (Series 90 
only). In this case, it may be convenient for you to link the offline recovery program 
immediately after you configure your IMS system, while your OS/3REL volume is still 
online. 


Standard job control streams for linking the offline recovery program ZC#TRC in a DTF 
system and a CDM system are shown in Figure 7-2. Note that linkage editor control 
statements must start in column 2 or beyond. 


Lines 1 through 10 are the same in both examples in Figure 7-2. The device 
assignment sets on line 2, and succeeding lines identify the library files containing the 
recovery and configuration object modules and the output load module. These may be 
omitted for modules stored in system libraries on SYSRES. The PARAM statement (line 
6) specifies where the linked module is to be stored; this must match the file name on 
the LFD statement for the output module. The WORK jproc (line 3) and the printer 
device assignment (line 4) are required by the linkage editor. 


Lines 8 through 17 in Figure 7-2a and 8 through 12 in Figure 7-2b are linkage editor 
control statements. The LOADM statement (line 8) assigns the name ZC#TRC to the 
output module. The LINKOP statement (line 9) directs the linkage editor not to 
automatically include modules or phases. This statement will cause unresolved EXTRNs 
to be generated; these should be ignored. INCLUDE statements for the recovery and 
configuration modules, (lines 10 and 11) are always required. 


in a DTF system (Figure 7-2a), the INCLUDE statement on line 12 is for a printer 1/O 
module, which is always required, and the INCLUDE statement on line 13 is for a SAT 
1/O module, required only for a tape trace file; you need not specifically include a SAT 
module for a disk or diskette trace file. Lines 14 through 16 include !/O modules for 
ISAM, DAM, and MIRAM data files. (Include the MIRAM I/O module if your files are 
organized as IRAM or MIRAM files.) Line 17 names ZE#OLREC as the entry point for 
the load module. 


In a CDM system (Figure 7-2b), printer, MIRAM, and SAT I/O modules need not be 
specifically included. Line 12 names ZE#OLREC as the entry point for the load module. 
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4 
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5. 
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0. 
1. 


2a 2 2 So om ae = 
Oo ON AU FW YP 


PB TDvdodoOaAnN aw FW 


JOB jobname 
// VOL vol-ser-no // LBL Library-name // LFD filename] 


DVC 5@ 


// WORK1 
// DVC 20 


// LFD PRNTR 


// EXEC LNKEDT 


// PARAM 
/$ 


OUT=f ilename 


LOADM ZCHTRC 

LINKOP NOAUT,NOV 
INCLUDE ZE#OLREC, filename 
ets 


cae 


INCLUDE 
CINCLUDE 
CINCLUDE 
CINCLUDE 
[INCLUDE 


ZS#TOnnn 
PRSIOE, S$YSOBJ 
$T$1110,$YSOBJ] 
1$$0313,$YSOBJ] 
DD$D111,$Y$OBJ} 
D3$M111,$Y$OBJ] 


ENTER ZE#OLREC 


/* 
/& 
// 





JOB jobname 
DVC 5@ // VOL vol-ser-no // LBL Library-name // LFD filename] 


// WORK‘ 


// DVC 20 // LFD PRNTR 
// EXEC LNKEDT 
// PARAM OUT=f ilename 


/$ 


LOADM ZC#TRC 

LINKOP NOAUT, NOV 
INCLUDE ZEHOLREC, filename 
ree: 


sia 


ZS$IOnnn 


ENTER ZE#OLREC 
/* 
/& 
// FIN 








a. DTF system 





b. CDM system 





Figure 7-2. Job Control Stream for Linking the Offline Recovery Program 
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7.4.2.2. Parameters for Offline Recovery 


The type of recovery performed by the ZC#TRC utility - forward, backward, or quick - 
and the files that are to be recovered are determined by parameters that you insert in 
the job control stream for executing ZC#TRC. Parameters also specify whether recovery 
is to be delimited by a date-time, whether partial recovery is to be performed on one or 
more files, whether a disk trace file must be closed, and listing options. 


All parameters are optional except RECOVERY-TYPE. They may be specified in any 
order and may begin in any column, but each must be submitted on a separate card. 
Parameters may not be split between cards; if all subparameters do not fit on one card, 
the keyword must be repeated on another card with the additional specifications. 


The format of the ZC#TRC parameters is: 


FORWARD 
QUICK 


[DATE-TIME=yy-mm-dd/hh:mm:ss] 


FILES=/(ALL 
filename-1,...,filename-n 


[PFILES=file-1[,...,file-n]] 


PRINT=( ALPHA 
BOTH 
HEX 


[TRCFILE=CLOSE] 


me fron | 


RECOVERY-TYPE Parameter: 


The RECOVERY-TYPE keyword parameter specifies whether forward, backward, or 
quick recovery is to be executed on the files named on the FILES parameter. If the 
FILES parameter is omitted (or FILES=NONE is specified) and the PRINT parameter 
is included, the RECOVERY-TYPE specification determines whether before- or 
after-images of records in the trace file are listed. If RECOVERY-TYPE=FORWARD 
is specified, after-images are printed; if RECOVERY-TYPE=BACKWARD or QUICK 
is specified, before-images are printed. 


RECOVERY - TYPE=BACKWARD 
Specifies backward recovery; the ZC#TRC utility applies before-images to the 
specified files. 


RECOVERY - TYPE=FORWARD 
Specifies forward recovery; ZC#TRC applies after-images to the specified files. 


RECOVERY - TYPE=QUICK 
Specifies quick recovery; ZC#TRC applies before-images to the specified files 
for all transactions active at the time of failure. 
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If the RECOVERY-TYPE parameter is omitted, ZC#TRC displays the message 
PARAMETER ERROR on the system console. 


DATE-TIME Parameter: 


The DATE-TIME keyword parameter specifies the point at which recovery is to 
terminate in each of the files rolled back or forward. All records are recovered up 
to the rollback point nearest to the specified date and time. 


DATE-TIME=yy-mm-dd/hh:mm:ss 
Specifies the date and time at which recovery is to terminate. Hyphens, the 
slash, and colons must be coded as shown. 


yy 

Specifies the year (00-99). 
mm 

Specifies the month of the year (01-12). 
dd 

Specifies the day of the month (01-31). 
hh 

Specifies the hour (00-23). 
mn 

Specifies the minute (00-59). 
ss 


Specifies the second (00-59). 


If the DATE-TIME keyword parameter is omitted, forward recovery terminates 
when EOF is reached; backward recovery terminates when the beginning of the 
volume is reached. 


NOTES: 


1. When you perform backward recovery using the DATE-TIME parameter, do 
not specify the exact date and time of a termination record. This can cause the 
recovered file to be in an inconsistent state. Instead, you should specify a time 
earlier than that of the termination record. 


2. Conversely, when you perform forward recovery, you should specify a time 
later than that of the termination record. 
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FILES Parameter: 


The FILES keyword parameter designates which files, if any, are to be recovered. 
In addition to your data files, you can also specify recovery of the TOMFILE 
partition of the AUDCONF or CONDATA file, if you included the TOMTRCE 
parameter at configuration. 


The filenames you specify for your data files are their LFD-names. However, you 
specify the file name for the TOMEFILE partition, even though its LFD name is 
AUDCONF or CONDATA. 


If you specify a data file name that you did not identify to the configurator (with the 
FILES keyword in the ACTION section), ZC#TRC displays the following message at 
the system console: 


FILE NAME filename-n INVALID 


Nevertheless, all files for which you have specified a valid (that is, configured) file 
name are recovered. 


FILES=ALL 
Specifies that all configured user data files are to be recovered. If you have 
configured TOMFILE tracing, the TOMFILE is also recovered. 


FILES=filename-1,...,filename-n 
Specifies one or more configured names of individual files that are to be 
recovered. 





Specifies that no files are to be recovered and is the default assumption. The 
ZC#TRC utility lists the trace file records, with prefixes, if the PRINT keyword 
is specified. 


PFILES Parameter: 


lf you have a file or files for which the ZZCLS and ZZOPN master terminal 
commands were issued during the IMS session (and which may have been 
accessed by other programs), you should include the PFILES parameter to perform 
partial recovery of those files. The PFILES parameter directs the offline recovery 
program to apply to the designated files only the before- or after-images recorded 
in the trace file after the last valid ZZOPN command was issued. This ensures that 
only IMS transactions are recovered, and any updates made to the file by other 
programs while the file was closed to IMS are not touched. 


In backward recovery, before-images are applied from the end of the trace file back 
to the last ZZOPN command (unless the date-time, if specified, is reached first). In 
forward recovery, after-images are applied from the last ZZOPN command to the 
date-time, if specified, or to the end of the trace file. 
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PFILES=filename-1[,...,filename-n} 
Specifies that recovery of the designated files is to start or end at the last 
valid ZZOPN command. : 


PRINT Parameter: 


The PRINT keyword parameter has two uses. When you specify it with file 
recovery, you get a listing of the recovered records, with information about each 
record as described in its prefix area in the trace file (Figure 7-2). You can also use 
it without file recovery to get a complete listing of records updated during an IMS 
session. You do this by specifying one of the PRINT options together with 
FILES=NONE (or omit the FILES parameter). ZC#TRC prints the before- or 
after-images of all records in the trace file (depending on your RECOVERY-TYPE 
specification), with their prefixes. 


PRINT=ALPHA 
Specifies an alphanumeric listing. 


PRINT=BOTH 
Specifies an alphanumeric and hexadecimal listing. 


PRINT -HEX 
Specifies a listing in hexadecimal. 





If the PRINT keyword parameter is omitted, no listing is provided. If you omit the 
PRINT keyword when FILES=NONE is indicated, explicitly or by default, no files are 
recovered and no records are printed. 


If you specify any of the PRINT options, you must allocate a print file to the 
ZC#TRC job. 


TRCFILE Parameter: 


When the object of recovery is to restore files after a system failure that has left 
the trace file open, this file must be closed before the ZC#TRC utility can carry out 
the type of recovery you have specified. The offline recovery utility itself can close 
the trace file only if the file is on disk or diskette; to cause it to do so, you must 
specify the TRCFILE keyword parameter. (To close a magnetic tape trace file left 
open by system failure, before submitting it to the ZC#TRC utility for use in 
recovery, follow the procedures detailed in 7.4.3.) 


TRCFILE=CLOSE 
Specifies that the ZC#TRC offline recovery utility is to close the disk/diskette 
trace file before carrying out the specified recovery operations. 
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7.4.2.3. Executing the Offline Recovery Utility 


A standard job control stream for executing the offline recovery utility is illustrated in 
Figure 7-3. 


JOB jobname,,min 

OPTION DUMP] 

DVC 20 // LFD PRNTR] 

DVC togical-unit-no // VOL vol-ser-no-1 [,vol-ser-no-n] 

LBL file-id{,file-serial-no] // LFD TRCFILE 

DVC logical-unit-no // VOL vol-ser-no // LBL file-id // LFD filename] 


i DVC logical-unit-no // VOL-vol-ser-no // LBL file-id // wis eae 


CONDATA 
// DVC lLogical-unit-no // VOL vol-ser-no // LBL file-id 
y LFD load-lib-name ] 
// EXEC ZCHTRC[,load-lib-name] 
/$ 
parameters 





Figure 7-3. Job Control Stream for Executing the Offline Recovery Program 


You must specify the minimum main storage requirement, in hexadecimal, with the min 
parameter of the JOB statement. To compute this size, add the length of the ZC#TRC 
load module as listed in the output from the ZC#TRC linkage (Figure 7-1), plus four 
times the largest blocksize of the files to be recovered, plus 4096. The decimal result 
of this calculation should be rounded upward to the next 256-byte boundary and 
translated to its hexadecimal equivalent. 


The device assignments, in the order they appear in Figure 7-3, are for: 
=~ A printer 


Must be assigned to the job if you included the OPTION DUMP statement or the 
PRINT parameter. 


= § A tape, disk, or diskette trace file 


For a multivolume magnetic tape trace file, the VOL statement lists each volume 
serial number. The optional file-serial-no parameter of the LBL statement must 
match the volume serial number of the first volume in the file, whether or not that 
volume is the first one listed on the VOL statement. 
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For a multivolume disk or diskette trace file, you must include a device assignment 
set for each volume, and you must define the volumes in the same sequence as 
they were defined at IMS start-up. 

w The data files that are to be recovered 


These device assignments are omitted if you use the PRINT option without file 
recovery. 


= The AUDCONF or CONDATA file 
Required if you are recovering the TOMFILE partition. 

a The load library containing the ZC#TRC load module 
This device assignment is omitted if ZC#TRC is in the $Y$LOD library on SYSRES. 
The load-lib-name parameter on the EXEC statement may also be omitted if 


ZC#TRC is in $Y$LOD. 


Typical job control streams for forward, backward, and quick recovery and for listing 
the contents of the trace file are shown in the following examples: 


Example 1 - Forward recovery: 





// JOB FORECOV, ,COO® 
// OVC 96 // VOL TAPE@1 // LBL TRACE // LFD TRCFILE 
// OVC 5@ // VOL DISKO1 // LBL DATAFL1 // LFD DATAFL1 


// DVC 51 // VOL DISKO3 // LBL DATAFLX // LFD DATAFLX 
// OVC 52 // VOL IMSFIL // LBL AUDCONF // LFD AUDCONF 
// OPTION DUMP 

// DVC 26 // LFD PRNTR 

// EXEC ZCHTRC 

/$ 

RECOVERY - TYPE=FORWARD 

FILES=ALL 

DATE-TIME=78-09-30/14:22:00 

PRINT=ALPHA 

PFILES=DATAFL1,...DATAFLX 

/*® 

/& 

// FIN 





The job stream in example 1 executes ZC#TRC for forward recovery of all 
configured data files and the TOMFILE. Because the PFILES and DATE-TIME 
parameters are both specified, recovery will start from the last valid ZZOPN 
command and end at the last transaction termination or rollback point before the 
date-time given. The PRINT parameter requests an alphabetic listing of the 
recovered records. The ZC#TRC program is loaded from $Y$LOD. 
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@ Example 2 - Backward recovery with date-time: 


// JOB BAKRECOV, ,DO0@ 

// OPTION DUMP 

// DVC 20 // LFD PRNTR 

// DVC 90 // VOL TAPEO1, TAPE@2, TAPEQ3 

// LBL TRACE,TAPE@1 // LFD TRCFILE 

// OVC 50 // VOL DISKO1 // LBL DATAFL1 // LFD DATAFL1 
// DVC 50 // VOL DISK®1 // LBL DATAFL2 // LFD DATAFL2 
// DVC 51° // VOL DISK®@2 // LBL CONDATA // LFD CONDATA 
// DVC 52 // VOL DISK®3 // LBL IMSLIB // LFD IMSLIB 
// EXEC ZC#TRC,IMSLIB 

/$ 

RECOVERY - TYPE=BACKWARD 

DATE -TIME=78- 10-25/09:30:00 
FILES=DATAFL1,DATAFL2, TOMFILE 

PRINT=BOTH 

/* 

/& 

// FIN 


The job stream in example 2 executes ZC#TRC for backward recovery of 
DATAFL1, DATAFL2, and the TOMFILE, ending at the date-time specified. The 


ee PRINT parameter requests both an alphabetic and a hexadecimal listing. The IMSLIB 
parameter on the EXEC statement identifies the library from which ZC#TRC is to be 
loaded. 


This example uses a multivolume magnetic tape trace file. Because the DATE-TIME 
parameter is specified, the trace file must be mounted first in the forward direction, 
then backward, and the VOL statement must list the volumes in the order in which 
they were created. 


Example 3 ~ Backward recovery without date-time: 


// JOB FULRECOV, , F000 

// OPTION DUMP 

// DVC 20 // LFD PRNTR 

// DVC 90 // VOL TAPE@3,TAPEO2,TAPEO1 

// LBL TRACE,TAPE@1 // LFD TRCFILE 

// DVC 5@ // VOL DISK®@1 // DATAFL1 // LFD DATAFL1 
// DVC 5@ // VOL DISK@1 // DATAFL2 // LFD DATAFL2 
// EXEC ZC#TRC 

/$ 

RECOVERY - TYPE=BACKWARD 

FILES=DATAFL1,DATAFL2 

PFILES=DATAFIL2 

/* 


e : 


// FIN 
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The job stream in example 3 executes ZC#TRC for backward recovery of & 
DATAFL1 and DATAFL2. The PFILES parameter specifies that DATAFL2 is to be 

rolled back to the last valid ZZOPN command; DATAFL1 is to be completely 

recovered. No listing is requested. Because the DATE-TIME parameter is not. 

specified, the trace file is read in the backward direction only. Volumes of the 

multivolume magnetic tape trace file in this example must be mounted in the 

backward direction, starting with the last volume, and the VOL statement must list 

the volumes in the reverse of the order in which they were created. 


Example 4 - Backward recovery using a diskette trace file: 


// JOB DISKET, ,D00 

// OPTION DUMP 

// DVC 20 // LED PRNTR 

// DVC 50 // VOL DATA // LBL EMPLOYEE // LFD EMPLOY 

// DVC 50 // VOL DATA // LBL PAYROLL // LFD PAYROLL 

// DVC 130 // VOL TRACE1 // LBL IMS.TRACE // LFD TRCFILE 
// DVC 131 // VOL TRACE2 // LBL IMS.TRACE // LFD TRCFILE 
// DVC 132 // VOL TRACES // LBL IMS.TRACE // LFD TRCFILE 
// EXEC ZCHTRC 

/$ | 
RECOVERY - TYPE=BACKWARD 

FILES=EMPLOY, PAYROLL 
/* 

/& 

// FIN 





The job stream in example 4 executes ZC#TRC for backward recovery of the 
EMPLOY and PAYROLL files, using a multivolume diskette trace file (available in 
System 80 only). Unlike a multivolume tape trace file, the volumes must be defined 
in the order they were created, and all volumes must be online during the entire 
procedure. 


Example 5 — Quick recovery: 


// JOB QUICKIE, ,C00O 

// OPTION DUMP 

// DVC 20 // LFD PRNTR 

// DVC 50 // VOL DISK®@1 // LBL TRACE // LFD TRCFILE 
// OVC 51 // VOL DISK@2 // LBL DATAFL1 // LFD DATAFL1 


// DVC 52 // VOL DISK®O3 // LBL DATAFLX // LFD DATAFLX 
// DVC 53° // VOL DISK@4 // LBL IMSLIB // LFD IMSLIB 
// EXEC ZC#TRC,IMSLIB 

/$ 

RECOVERY - TYPE=QUICK 

TRCFILE=CLOSE 

FILES=ALL 








continued 
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PRINT=BOTH 
/* 

/& 

// FIN 


The job stream in example 5 executes ZC#TRC for quick recovery of all data files. 
The TRCFILE parameter closes the disk trace file, which was left open at the time 
of system failure. The PRINT parameter requests both an alphabetic and 
hexadecimal listing of recovered records. 


Example 6 - Listing the records in the trace file: 


// JOB LIST, ,CO00 

// DVC 20 // LFD PRNTR 

// DVC 5@ // VOL DISK®1 // LBL TRACE // LFD TRCFILE 
// EXEC ZCHTRC 

/$ 

RECOVERY - TYPE=FORWARD 

PRINT=ALPHA 

/* 

/& 

// FIN 


The job stream in example 6 generates an alphabetic listing of records in the trace 
file, with no recovery of data files. Because RECOVERY-TYPE=FORWARD is 
specified, the records listed will be the after-images of all records updated since 
the beginning of the trace file. 


7.4.3. Closing a Magnetic Tape Trace File 


When a trace file is left open as a result of system failure, it must be properly closed 
before it can be used by the offline recovery utility or by the next online IMS session. 
Both the offline recovery utility and the online IMS program are capable of closing a disk 
or diskette trace file, but they cannot close a magnetic tape trace file. 


An open tape trace file cannot be closed directly. The last volume of the file must be 
copied onto another tape volume that is at least as large as the original tape and then 
closed. The tape copy routine ZC#TCP performs this procedure. The new output file 
produced by ZC#TCP can then be used by the offline recovery program or, if you are 
using warm restart instead of offline recovery, assigned to the online IMS job. 


7.4.3.1. Linking the Tape Copy Routine 


The tape copy routine is provided in the form of an object module, ZE#COPY, in the 
$Y$OBJ library file on SYSRES or OS3/REL (Series 90 only), depending on the SYSGEN 
option you selected (1.3). You must execute the linkage editor to produce the load 
module ZC#TCP. In a DTF system (but not in a CDM system), you must include the 
tape sequential access method 1/O module DD$T111. 
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If you selected the IMSGEN option at SYSGEN (Series 90 only) and you use a tape trace 
file, you should link the tape copy routine immediately after configuration, while your 
OS3/REL volume is still online. 


A standard job control stream for linking the tape copy routine ZC#TCP is shown in 
Figure 7-4. 


// JOB jobname 
// DVC 20 // LFD PRNTR 
[// DVC 5@ // VOL vol-ser-no // LBL obj-lib-name // LFD filename] 
{// DVC 51 // VOL vol-ser-no // LBL load-lib-name // LFD filename] 
// WORK1 
// EXEC LNKEDT 
// PARAM OUT=filename 
/$ 
LINKOP NOAUT,NOV 
LOADM ZCHTCP 
INCLUDE ZEH#COPY, filename 
[INCLUDE DD#T111,$YSOBJ ] 
ENTER ZE#COPY 
/* 
/& 
// FIN 


CNA U FWD = 





Figure 7-4. Job Control Stream for Linking the Tape Copy Routine 


The disk device assignment sets identify the library files containing the ZE#COPY 
module (line 3) and the output load module (line 4). These may be omitted if the 
modules are stored in $Y$OBJ and $Y$LOD on your SYSRES volume. The PARAM 
statement (line 7) specifies where the output module is to be stored. The printer device 
assignment (line 2) and the WORK jproc (line 5) are required by the linkage editor. 


Lines 9 through 13 are linkage editor control statements, which must start in column 2 
or beyond. The LINKOP statement (line 9) directs the linkage editor not to automatically 
include modules or phases. The LOADM statement (line 10) assigns the name ZC#TCP 
to the output module. This statement will cause unresolved EXTRNs to be generated; 
these should be ignored. Lines 11 and 12 include the tape copy module and the tape 
SAM 1/0 module in the output load module. Line 13 names ZE#COPY as the entry point 
for the load module. 


7.4.3.2. Executing the Tape Copy Routine 


A standard job control stream for executing the tape copy routine is shown in Figure 
7-5. The ZC#TCP program requires 8000 hexadecimal bytes of main storage, specified 
on the JOB card. Assignment of a printer is also required. A load library need not be 
assigned if ZC#TCP is in $Y$LOD. 
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: JOB jobname, ,8000 


DVC 20 // LFD PRNTR 
DVC 96 // VOL vol-ser-no // LBL file-id // LFD INPUT 
DVC 91 // VOL vol-ser-no // LBL file-id // LFD OUTPUT 


DVC 50 // VOL vol-ser-no // LBL file-id // LFD load-lib-name] 
EXEC ZC#TCP[, load-lib-name] 


FIN 





Figure 7-5. Job Control Stream for Executing the Tape Copy Routine 


ZC#TCP closes the new file produced by this run when it detects an error condition in 
the input volume. The following message is displayed on the system console: 


DEVICE=420 STATUS=2600 SENSE=08C0 TAPE FAULT=xUxx 


This message should be ignored. 
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8. IMS Statistical Reporting 


8.1. STATISTICAL REPORTING FUNCTIONS 


As an IMS administrator or analyst, you will often find it very useful to know what 
activities take place on your system and where they occur. To assist you, IMS provides 
a Statistical file, STATFIL, for recording system activity and an offline print program to 
print that file. The statistical file print program is available in both single-thread and 
multithread IMS. 


If you want IMS to create a statistical file, you must allocate and initialize this file at 
configuration time and assign it in the IMS start-up job control stream. Once the file has 
been created, you can use the ZSTAT transaction to write IMS statistical data in it. The 
ZSTAT transaction is documented in the IMS terminal users guide, UP-9208 (current 
version). User-written action programs can also put user-originated statistics into the 


file. 

If you include the STATS=YES parameter in the OPTIONS section at configuration, IMS 
automatically schedules ZSTAT at shutdown time and records statistics for the entire 
IMS session. 


The offline statistical file print program, ZC#ZSF, prints the data recorded by ZSTAT in 
a neatly formatted report. This report contains statistics on: 


a= files 

= = =programs 

@ transactions 

= = ~=6 terminals 

Normally, statistics are accumulated from the beginning of an IMS session. When you 
use PARAM RESTART at IMS start-up in a multithread system, statistics are carried 


forward from the preceding session. 


The statistical print program does not print user-generated statistics; you must write 
your own program to do this. 
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8.2. STATISTICAL DATA RECORDED BY ZSTAT 

IMS statistics record some of the activities that take place in an IMS session. They 
enable you to analyze the way files, transactions, programs, and terminals are being 
used. 

8.2.1. File Statistics 

For each user file accessed during the session, the offline print program prints: 

= ~= the file name and whether it was open or closed when ZSTAT was executed; 

= the number of times the file was accessed during the session; and 

= the number of times the file was updated during the session. 

The total number of file accesses and file updates in the session are also printed. Figure 


8-1 shows an example of file statistics printed by ZC#ZSF. 


10/05/81 15:51:02 


FILE STAT ACCESSES UPDATES 
CUSTFIL OPEN vy) 
AUDFILE OPEN @ 


PRODFIL CLSD @ 
STATFIL OPEN 15 
NAMEREC OPEN t) 


TOTALS 15 





Figure 8-1. File Statistics Printed by the STATFIL Print Program 


8.2.2. Program Statistics 

For each program executed during the session, the offline print program prints: 

= the program name and whether it was up or down when ZSTAT was executed; 
m the program type - serial, reentrant, or shared (multithread only); 

= whether or not the program is resident; 

= ~=«whether this is a subprogram; 

= the number of times the program was accessed during the session; and 


mw the number of times the program was loaded during the session. 
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The offline statistical print program also prints the total number of program accesses 
and program loads that took place during the session. Figure 8-2 shows an example of 
program statistics printed by ZC#ZSF. 


10/05/81 15:51:09 


PROGRAM STAT TYPE RES SUB ACCESSES LOADED 
ZM#BEGOO UP SERIAL 1 1 
ZU#OPNOO UP RE- ENTRANT 


ZM#FLEOO UP SERIAL 
ZM#HTER SERIAL 


TOTALS 





Figure 8-2. Program Statistics Printed by the STATFIL Print Program 


8.2.3. Transaction Statistics 


For every transaction that took place during the session, ZC#ZSF prints: 


the transaction name; 

how many times the transaction was accessed; 

the number of input and output messages it processed; 

the number of file accesses it made; 

the number of remote accesses by this transaction (for DDP only); and 


the name of the remote system (locap-name) where the transaction is processed 
(DDP only). 


The following totals are also printed: 


number of transaction accesses 
number of input and output messages 
number of file accesses 


number of remote accesses 


Figure 8-3 shows an example of transaction statistics printed by ZC#ZSF, and Figure 
8-4 illustrates transaction statistics for a DDP environment. 
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10/05/81 15:51:20 

TRANSACT ACCESSES INPUT OUTPUT FILE-ACC 

DISP @ C) 0 ) 

SWTCH @ t) ® ® 

ZSTAT 1 4 4 8 
TOTALS 1 4 4 8 





Figure 8-3. Transaction Statistics Printed by the STATFIL Print Program 


10/05/81 15:51:20 


TRANSACT ACCESSES OUTPUT 
DISP 


INVEN 

ZSTAT 

DISP 
TOTALS 





Figure 8-4. Transaction Statistics for DDP Users 


8.2.4. Terminal Statistics 


For every terminal that was active during the session, the statistical display program 


prints: 

@ the terminal-id 

m the transaction code of the current transaction, if any 

m = its status at the time ZSTAT was executed: up, physically down, logically down, in 
test mode, or in hold status 

@ the number of input and output messages processed 

m= the number of transactions processed 

m the number of terminal commands processed 

t) 


the number of input and output characters processed 


In addition, ZC#ZSF prints the following totals: 


number of slots remaining (for global networks only) 
number of input and output messages processed 


number of transactions executed 
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= = =number of terminal commands processed 
= = =~=number of input and output characters processed 


= length of the longest input message processed and the id of the terminal where it 
occurred 


m length of the longest output message processed and the id of the terminal where it 
occurred. 


Figure 8-5 shows an example of terminal statistics printed by the STATFIL print 
program. 


10/05/81 15:51:24 
TERM STAT TRANSCODE IN-MSG OUT-MSG TRANS COMM IN-CHAR OUT -CHAR 
TRM1 DP @ @ i) ty) 


TRMC UP ZSTAT 39 3271 

TRMA UP 15 250 
TOTALS 54 3521 - 
MAX-IN= 24(TRMC) MAX -OUT= 1660(TRMC) 





Figure 8-5. Terminal Statistics Printed by the STATFIL Print Program 


8.3. CONFIGURATION AND START-UP REQUIREMENTS FOR STATISTICAL 
REPORTING 


If you wish to create a statistics file, you must allocate and initialize it at configuration 
time. You allocate the statistics file with the IMSFIL or IMSFIL4 parameter of the 
IMSCONF jproc (4.2.8), and initialize it with the INIT parameter (4.2.9). 


You must also assign the file in the job control stream at IMS start-up. 


lf you want statistical data to be recorded at shutdown time, specify the STATS 
parameter in the OPTIONS section of your input to the configurator (4.3.3. 16). 


8.4. RECORDING STATISTICAL DATA DURING ONLINE PROCESSING 


There are two ways you can write records on the statistical file during online 
processing. One is by using the ZSTAT transaction, the other is through user-written 
programs that put your own statistical data in the file. 


You must remember, however, that the offline print program, ZC#ZSF, prints only the 
data recorded by ZSTAT. It ignores statistics recorded by user-written programs. 


ZSTAT generates statistics and writes them into the file every time you request it to do 
so. (You can also direct ZSTAT output to the master terminal or to an auxiliary device.) 
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ZSTAT allows you to choose which data you want to record on the statistical file. If 
you specify ZSTAT ALL, FILE or ZSTAT ALL, FONLY all the data listed in 8.2 is 
recorded. If you enter only ZSTAT, with no parameters, you receive a menu on your 
screen. This enables you to specify that only the data you select is to be recorded in 
the file. 


For a complete description of the ZSTAT transaction, refer to the IMS terminal users 
guide, UP-9208 (current version). 


If you include the STATS parameter in the OPTIONS section at configuration, IMS 
automatically schedules ZSTAT at shutdown time and records all statistics from the 
IMS session in STATFIL. 


8.5. PRINTING THE STATISTICAL FILE OFFLINE (ZC#ZSF) 
To print the statistical file offline, you run the ZC#ZSF program. This program retrieves 
only the statistics you recorded by executing the ZSTAT transaction. It ignores any 


statistical data placed in the file by user-written programs. 


The ZC#ZSF program does not require any parameters. Figure 8-6 shows the job 
control stream for executing ZC#ZSF. 


JOB jobname 

OPTION DUMP 

DVC 20 // LFD PRNTR 

DVC logical-unit-no // VOL vol-ser-no 


LBL file-id // LFD STATFIL 
EXEC ZC#ZSF 


FIN 





Figure 8-6. Job Control Stream for Executing the Statistical File Print Program 


When the program finishes execution, it displays the message: 


END OF FILE REACHED. ZC#ZSF TERMINATED 


8.6. CONTENTS OF THE STATISTICAL DATA FILE 


If you wish to write your own program for recording or printing statistical data in the 
file, refer to Tables 8-1 through 8-9 for the file layout. (The data your program writes 
in the file is ignored by ZC#ZSF, so you must also write your own statistical print 
program.) The statistics file is a sequential unkeyed MIRAM file with variable-length 
records. The first four bytes of each record are not easily accessible when you are 
using COBOL, so the record length field is repeated in the data portion of the record. 
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Table 8-1. Contents of Date/Time Stamp Record 


Length Record length. X'0016' 
Record Control Block Indicates record has been logically deleted 


Unused Not used by data management 


Record Length Adjusted record length (‘Length’ - 4) 


Unused Reserved for future use 
Identifier Defines the following record: 
DF for file statistics 
DP for program statistics 
DT for transaction statistics 
DD for transaction statistics created by DDP users 
DC for. terminal statistics 
In the format DDMMYY 


In the format HHMMSS 





Table 8-2. Contents of File Statistics Record 


Length Record length (number of files * 32) + 10 
Record Control Byte Indicates if record was logically deleted 
Unused Not used by data management 
Record Length Adjusted record length (‘Length’ - 4) 


Repeat Count Number of times ‘file-name’ through ‘updates’ is repeated 


Identifier Fl, to identify record as file statistics 
File-name File name 
Status OPEN Open 

CLSD Closed 

XXXX Invalid file name 
Type MRAM MIRAM 

SAM SAM 

ISAM ISAM 
Accesses Number of times file was accessed 
Updates Number of times file was updated 
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Table 8-3. Contents of File Totals Record 


Length Record length. X‘O01A' 





Record Control Byte Indicates record was logically deleted 


Unused Not used by data management 


Record Length Adjusted record length (‘Length’ ~ 4) 


Unused Reserved for future use 
Identifier FT File Totals Record 
Total-accesses Total number of file accesses 


Total-updates Total number of file updates 





Table 8-4. Contents of Program Statistics Record 


Length Record length (number of programs * 32) + 10 


Record Control Byte Indicates record was logically deleted 





Unused Not used by data management 
Record-length Adjusted record length (‘Length’ - 4) 
Repeat Count Number of times ‘program-name’ through ‘loads’ is repeated 
Program-name Program name 
Status UP Up 
DN Down 
XX Invalid program name 
SH Shared 
SE Serial 
Reentrant 
Resident Yes 
No 
Subprogram 


No 


Accesses Number of times program was accessed 





Loads Number of times program was loaded 
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Table 8-5. Contents of Program Totals Record 


Length Record length X‘001A’ 


Record Control Byte Indicates if record was logically deleted 


Unused Not used by data management 


Record-length Adjusted record length (‘Length’ - 4) 

Unused Reserved for future use 

Identifier PT Program Totals 

Total Accesses Number of times the programs were accessed 


Total Loads Number of times the programs were loaded 





Table 8-6. Contents of Transaction Statistics Record 


Length Record length (number of transactions * 52) + 10 
Record Control Byte Indicates if record was logically deleted 
Unused Not used by data management 
Record-length Adjusted record length (‘Length’ - 4) 
Repeat-count Number of times ‘transaction-code’ through ‘locap-name’ is repeated 
Identifier TR Transaction Statistics Record 
TD Transaction Statistics Record in DDP system 
Transaction code 
Accesses Number of times transaction was accessed 
XXXXXXXX_ Invalid transaction code 


Input-messages Number of input messages processed by this transaction 


Output-messages Number of output messages processed by this transaction 


File-accesses Number of user file accesses made by this transaction 
Remote-accesses Number of remote accesses by this transaction (ODP only) 


Locap-name Name of remote system (DDP users only) 
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Table 8-7. 


Field Name Bytes 


Length 

Record control byte 
Unused 

Record-length 

Unused 

Identifier 
Total-accesses 
Total-input-messages 
Total-output-messages 
Total-file-accesses 


Total-remote accesses 


Contents of Transaction Totals Record 


Description 
Record length. X‘0012’ ) 
Indicates if record was logically deleted 
Not used by data management 
Adjusted record length (‘Length’ - 4) 
Reserved for future use 
TT Transaction Totals (TP in DDP system) 
Total number of accesses 
Total number of input messages 
Total number of output messages 
Total number of file accesses 


Total number of remote accesses (DDP only) 





Table 8-8. Contents of Terminal Statistics Record (Part 1 of 2) 


Field Name Bytes Description 


Length 

Record Control Byte 
Unused 
Record-length 
Repeat-count 
Identifier 

Terminal-id 


Status 


Record length (number of terminals * 52) + 10 


indicates if record was logically deleted 
Not used by data management 


Adjusted record length (‘Length’ - 4) 





Number of times ‘terminal-id’ through ‘output-characters’ is repeated 


TE Terminal Record 
Terminal identification 
UP Up 

DL Down logically 
DP Down physically 
TM Test mode 


HL = Hold 


SS  $$SOFF (global networks only) 


XX Invalid terminal-id 
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& Table 8-8. Contents of Terminal Statistics Record (Part 2 of 2) 
Field Name Bytes Description 


Input-messages 17-22 Number of input messages processed 


Output-messages 23-29 Number of output messages processed 


Transactions 30-34 Number of transactions processed 


Commands 35-38 Number of commands processed 
Input-characters 39-46 Number of input characters processed 


Output-characters 47-54 Number of output characters processed 





Table 8-9. Contents of Terminal Totals Record 


Length 0-1 Record length. X‘0050’ 

Record control byte 2 Indicates if record was logically deleted 
& Unused 3 Not used by data management 

Record-length 4-5 Adjusted record length (‘Length’ - 4) 

Unused 6-7 Reserved for future use 

identifier 8-9 TO Terminal Totals 

Slots 10-13 Number of slots remaining (in global network) 

Total-input-messages 14-19 Total number of input messages 

Total-output-messages 20-26 Total number of output messages 

Total-transactions 27-31 Total number of transactions processed 

Total-commands 32-35 Total number of commands processed 

Total-input-characters 36-47 Total number of input characters processed 

Total-output-characters 48-59 Total number of output characters processed 

Max-input-characters 60-67 Length of single largest input message 

Max-input-terminal 68-71 Terminal-id at which the single largest input message occurred 


Max-output-characters 72-79 Length of single largest output message 


Max-output-terminal 80-83 Terminal-id at which the single largest output message occurred 
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Appendix A. Statement Conventions 


A.1. GENERAL RULES 


Throughout this document, certain conventions are observed for statement and 
parameter formats. General rules with examples pertaining to these conventions follow. 
Specific rules for coding input to the IMS configurator are given in A.2. Additional 
coding conventions are described in the appropriate sections of this manual; you should 
also refer to the job control user guide, UP-8065 (current version) for coding 
conventions relating to job control statements and procedures (jprocs). 


m= Uppercase words, codes, and letters are coded exactly as shown, as are commas 
and equal signs. Braces { } and brackets [ ] are never coded. 


= Lowercase letters and words are generic terms representing information that must 
be supplied by the user. Such terms may contain acronyms and hyphens for 
readability. 


Examples: 


DDRECORD=record-name 


program-name 


m= = Information presented within braces represents alternate choices, of which only one 
may be chosen. 


Example: 


EDIT=/table name 
FCCDICE 
c 
NONE 
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Information presented within brackets represents optional entries that may be 
coded or omitted, depending on individual system requirements. Braces within 
brackets signify that one of the entries within braces must be chosen if the 
bracketed parameter is coded. 


Example: 


age) 


A keyword parameter consists of a word or code immediately followed by an equal 
sign (=), which in turn is followed immediately by a response, or specification. 
Keyword parameters, although they appear in the format delineations in alphabetic 
order, may be coded in any convenient order. 


Example: 
DATE-TIME=yy-mm-dd/hh:mm:ss 
A positional parameter is presented in lowercase letters and is not followed by an 
equal sign (=). Positional parameters are presented before keyword parameters in 
the format delineation and must be coded before any keyword parameters. 
Example: 
trans-code 
An optional parameter with a list of optional specifications may have a default 
assumption supplied by IMS when the parameter is omitted by the user. When the 
default value assumed by IMS occurs in the format delineation, it is printed on a 
shaded background. When IMS performs some other default action when an 
optional parameter is omitted, this is explained in the parameter description. 
Example: 
RECOVERY=( AFT 
ALL 
BEF 
ue 
An ellipsis (a series of three periods) occurring in a format delineation indicates the 
possibility of coding a variable number of repeated entries. The ellipsis itself is 
never coded. 


Example: 


FILES=filename-1[,...,filename-n] 
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A.2. RULES FOR CODING CONFIGURATOR INPUT 


Rules and examples for coding input to the configurator follow. These are in addition to 
the general rules presented in A.1. 


™ Section names input to the IMS configurator are presented in the leftmost position 
of the format delineation, in uppercase. They are coded exactly as shown and must 
begin in column 1. 
Example: 


NETWORK | BATCH=(n 





See 


YES 


CONFID=n 
[NAME=network - name ] 
[PASSWORD=password-name] 


m Parameters are presented to the right of the section name and are stacked 
vertically. A positional parameter, if it occurs, is presented before all keyword 


parameters; the latter are presented in alphabetic order for ease of reference in the 
illustration. 


Example: 


TRANSACT trans-code 
[ACTION=program-name] 


laa 2) 


m= Parameters are separated from each other and from the section name by one or 
more spaces. Commas are not used to delimit parameters. If a positional parameter 
appears in the format delineation, it must always be included and must be the first 
parameter coded. 


Example: 
TRANSACT CHG ACTION=CHANGE 


= When coding multiple parameters for a section of input to the configurator, no 
input may be coded beyond column 71. When continuation is necessary, or when 
it is desirable for readability, whole parameters may be coded on continuation 


cards. None may be split, nor may any begin in column 1. Column 72 remains 
blank. 
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Example: 
OPTIONS RECLOCK=YES FUPDATE=YES 
UNSOL=YES UNIQUE=RES 


INTLIST=NO RECOVERY=ALL 
RESEND=YES 


Multiple specifications, or subparameters, may be coded for certain keyword 
parameters if so shown in the format delineation. These subparameters, when 
coded, are separated from each other by commas, without intervening spaces, if 
indicated in the format. 
Example: 

ACTION PAYROLL FILES=MAINFLE,PAYDAY,ACTREC, EMPLYS 


Subparameters may span two or more cards by repeating the keyword on 
continuation cards with the additional specifications. 


Example: 
ACTION UPDATE MAXSIZE=1000 OUTSIZE=204 
EDIT=% FILES=MAINFIL,PAYROLL,ACCTREC,ACCTPAY 
FILES=STATS, EMPLOYS 


Keyword parameters, the response to which is YES or NO, may alternatively be 
specified in the abbreviated form: Y or N. 


Examples: 


FUPDATE=YES 
FUPDATE=Y 


With the exception of the EDIT, RCHAR, and UCHAR keywords, positional and 
keyword parameter specifications may use only the following characters: 


- Alphabetic: The uppercase letters A through Z 
- Numeric: O through 9 
~ Special letters: The characters ? $ # @ 


The EDIT, RCHAR, and UCHAR specifications may use any characters from this list 
and any additional special characters available on your terminals. 


If Katakana support is configured, Katakana characters may be used in transaction 
codes, UNIQUE lexicons, defined file names, data definition records, routing 
characters, and urgent priority characters. 
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@ = The following words are reserved and must not be used in configurator input as 
the names of files, transactions, actions, or programs: 


- IMS internal file names: NAMEREC, AUDFILE, AUDCONF, CONDATA, TRCFILE, 
TOMFILE, STATFIL, PRNTR, PRNTR1, PRNTR2, PRNTR3, PRNTR4. 


- IMS transaction codes, lexicon names, and terminal commands: CHTBL, DITBL, 
DLMSG, DLOAD, Jil, SWTCH, ZSTAT, ZZALT, ZZBTH, ZZCLS, ZZCNC, 
ZZCNS, ZZDWN, ZZHLD, ZZHLT, ZZMCH, ZZNRM, ZZOPN, ZZPCH, ZZRDY, 
ZZRSD, ZZSHD, ZZTMD, ZZTST, ZZUP. 

NOTE: 


OPEN cannot be used as a transaction code but may be used as a lexicon 
name. 


- Module names of IMS-supplied action programs (Figure D-9) 
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Appendix B. Estimating Main Storage 
Requirements for IMS 


B.1. GENERAL 


This appendix provides guidelines for estimating the main storage requirements for 
executing single-thread and multithread IMS systems under OS/3. The approximate 
requirements documented here are subject to change as new features are added to IMS 
in future releases and should be expected to be revised upward. (They are accurate 
to within +10%.) 


B.2. JOB REGION SIZE FOR SINGLE-THREAD SYSTEMS 


IMS can be configured to run under OS/3 in a job region as small as 48,816 bytes. The 
size of the job region is specified on the JOB job control statement when executing 
IMS. 


You have various options, when configuring IMS, that increase the size of the required 
job region. Figure B-1 illustrates the calculations for the major components that 
comprise a small system; the subsequent tables and text explain how user options can 
increase the size of some of those components. 
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Components 
DTF System CDM System 
Required program modules and tables 30,986 32,636 
Named record file {/O area (block size 2,560 2,560 
of named record file) 
Optional program modules. See Table B-1. a eee ae 
Optional tables (10 terminals). See Table B-2. 2,880 2,880 




















MIRAM RIiBs). See Table B-2. 
ee 
a 
en 


Figure B—1. Sample Calculation of Job Region Size Required by a Near-Minimum Single-thread IMS System 













B.2.1. Optional Program Modules 


Table B-1 lists the increments in the size of a single-thread IMS load module that result 
from specifying appropriate configurator keywords for certain optional functions. Refer 
to Section 4 for configuration details. 


Table B—1., Effects of Configurator Options on the Size of a Single-thread IMS Load Module (Part 1 of 2) 


NETWORK eAneae | | 16,156 16,300 
YES 


Global network CUP=locap-name 1,288 1,288 


DMS interface DMS=YES 1,940 1,940 
(3,796 if defined 
record management 
is configured) 


Fast load feature 
File updating 
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Table B—1. Effects of Configurator Options on the Size of a Single-thread IMS Load Module (Part 2 of 2) 


OPTIONS INTLIST = YES 























Interrupted LIST 
command 





(cont) 






Console transaction OPCOM= YES 6,064 (1,298 6,064 
processing if master termina! 

is defaulted 

to console) 









Record locking across RECLOCK= YES 


actions 












en coe 


Offline recovery 
Resend command 
Screen format services 


User-written subprograms 
Audit of output 
messages 


ALL 


BEF 





RECOVERY = fa 


























Tracing of output TOMTRCE= YES None None 

messages (TOMFILE= YES (TOMFILE= YES 
must be must be 
specified.) specified.) 


Resident UNIQUE UNIQUE=RES 2,016 2,016 

Unsolicited output UNSOL= YES 2,325 2,325 

DAM files FILETYPE=DAMR Not available 
292 





Prensa [150 | none 
Treresnm [a2 | vatvanae 


Sequential tape files FILETYPE= TMRAM Not available 3,232 
(CDM) 
Expanded input editing ACTION EDIT =tablename 2,532 2,532 


Resident defined DRCRDMGT RESIDE= YES 1,088 1,088 
record management 

File updating through UPDATE=YES 

defined record management 
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B.2.2. Optional Control Tables 


Each type of control table generated by IMS has a characteristic size to be used in 
estimating your main storage requirements for single-thread IMS. Table B-2 lists these 
and indicates the factor by which to multiply each. 


Table B—2. Single-thread Control Table Sizes 


Table Size Multiply by 
Wik ai ee 
Terminal control terminals (TERMS=n 
in NETWORK section) 
Transaction control transaction codes 
{TRANSACT sections) 
Action control actions 
(ACTION sections) 


{PROGRAM sections) 


CDIB file control MIRAM disk files and 
sequential tape files 
RIB file control 


B.2.3. Optional Resident Action Programs 




















Into your total main storage requirements you must add the size of each action program 
for which you have specified RESIDE=YES in the PROGRAM section of your 
configurator input. Further, if the action program is serially reusable (TYPE=SER), you 
must round this program size upward to the nearest multiple of the basic 512-, 1024-, 
or 2048-byte segment of main storage protected in your hardware configuration. The 
maximum-allowable-size action program in a single-thread configuration is 65K bytes; 
the maximum size for a resident subprogram is also 65K bytes. 
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B.2.4. Action Program Main Storage Pool Requirement 


Each action has a unique main storage pool space requirement; the largest of these 
requirements must be determined in order to estimate the size you will require for the 
main storage pool in a single-thread IMS system. (Because only one action is processed 
at a time in single-thread mode, there is no reason for the main storage pool to exceed 
the largest requirement.) 


Each action’s main storage pool requirement is the sum of three figures: 


1. the size of the largest nonresident action program to be called by the action - 
specified with the MAXSIZE keyword parameter in the ACTION section (the 
maximum allowable size is 65K bytes); 


2. the size of the activation record; and 
3. the size of the action’s I/O area. 


Figure B-2 contains a schedule for calculating the size of an action’s activation record 
and indicates the items to be summed. The result of calculations in Part 2 of the figure 
is entered as the sixth item in Part 1 (if the action accesses a defined file). 


The !/O area size must allow room for all of the data blocks that an action can acquire 
concurrently and is at least 1280 bytes if UNIQUE is specified for the action. Each data 
block's length is that specified via the BLKSIZE keyword parameter for its file, input in 
the FILE section to the configurator, and rounded up to a multiple of 256 bytes. A data 
block is acquired and released during the execution of a GET or INSERT file 1/O function 
call. It is acquired by a SETL or GETUP function call and released by the corresponding 
ESETL, PUT, or DELETE function call. 
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ne eu an ara Deere | 
ous nse wt at of OSE amet —[ 
cen a abet ase eereey | 
et wn  WORRSRE amen | 


Defined record area (If DFILE parameter specified. From 
bottom line of Part 2.) 
(Sum) Total for activation record: ———s 


NOTE: 









nis the number of decimal bytes specified with the SHRDSIZE keyword 
parameter if the action is a shared code COBOL action program (4.3.8.14). 


a. Part 1 


ee 
[asm ingens meneame | 
CS 













Length of longest identifier 









Length of longest source record key 


Length of largest source record (primary part) Bal 


Length of largest source record (supplementary part) 

(Sum) Total for defined record area: 

(Enter as sixth item of Part 1) 
b. Part 2 


Figure B—2. Schedule for Calculating Size of the Activation Record 
Required for an Action in Single-thread IMS 





B-6 
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B.2.5. AUDCONF Audit File 1/O Area 
The AUDCONF area is used to contain a single before-look. It must be large enough to 
contain the largest before-look for any file that can be updated. Before-look size is 
computed differently for indexed and nonindexed files and fixed- and variable-length 
records: 
m ISAM - fixed-length records; indexed MIRAM 

60 + RECSIZE value + KEYLEN value 
m ISAM - variable-length records 

60 + BLKSIZE value + KEYLEN value 
= nonindexed MIRAM 

60 + RECSIZE value 
= DAM 

60 + BLKSIZE value 


In each case, the computed size must be rounded upward to a multiple of 256. 


B.2.6. TRCFILE Trace File I/O Area 
The TRCFILE area is used to contain one or more before-looks and after-looks. It must 
be large enough to contain the largest look for any file which can be updated. Look size 
is computed differently for indexed and nonindexed files and for fixed- and 
variable-length records. This result is rounded upward to a multiple of 256: 
w ISAM - fixed-length records; indexed MIRAM 

114 + RECSIZE value + KEYLEN value 
m ISAM - variable-length records 

114 + BLKSIZE value + KEYLEN value 
= nonindexed MIRAM 

114 + RECSIZE value 
a» DAM 


114 + BLKSIZE value 
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B.3. JOB REGION SIZE FOR MULTITHREAD SYSTEMS 


The job region size needed to run multithread IMS under OS/3 can vary considerably 
depending on the requirements of the user. Certain modules and tables are fixed and 
necessary for any user to run IMS. However, many of the options will increase the 
required size by various amounts. An action program main storage pool is always 
required; B.3.4 describes how to calculate this requirement. In general, the pool 
requirement for two or three concurrent threads is between 50K and 60K bytes. 


Figure B-3 provides an example of calculations of main storage required for a 
multithread IMS system. 


Components 
DTF System CDM System: 


Required program modules and tables 62,101 64,202 


Named record file [/O area (block size of 6,144 
named record file) 
Optional tables (6 terminals, 1,728 1,728 
2 transactions, 2 actions, 4 programs). 
See Table B-4. 
Optional files (4 user-specified ISAM DTFs or 1,824 
MIRAM RIBs). See Table B-4. 















Resident action programs. See B.3.3 
Input message buffer 3,000 
(% (max screen x no. of terminals)) 


Action program main storage pool (approx.) 60,000 60,000 
See Figure B-4. 
Total (approx.) 134,797 135,698 


Figure B-3. Sample Calculation of Job Region Size Required by a Multithread IMS System 





B.3.1. Optional IMS Features 


Table B-3 summarizes the optional IMS features that may be specified for a multithread 
system and indicates the sizes of the additional modules to be included. Refer to 
Section 4 for configuration details and to Appendix D for the location of the modules. 
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Table B—3. Effects of Configurator Options on the Size of a Multithread IMS Load Module (Part 1 of 2) 


inrament in Size fovied 

























Batch processor NETWORK BATCH=1 16,052 
BATCH=2 22,400 
BATCH=3 28,748 
BATCH=4 35,096 










Global network CUP =locap-name 1,489 1,489 
Continuous output OPTIONS CONTOUT= YES 1,558 


Downline loading 1,744 
DMS interface 2,096 
Fast load feature 5,672 
File updating © FUPDATE= YES 1,248 


OPCOM= YES 6,064 6,064 
(Same if master 
terminal is 
defaulted to 
console) 


RECOVERY us| 







Console transaction 
processing 





Offline recovery @ 
ALL 
BEF 





1,417 1,255 


Screen format services 4,843 4,843 
Edited snap dump SNAPED= YES 2,842 2,842 

User-written subprograms SUBPROG = YES 608 
412 


Auditing of output TOMFILE= YES 


diac Le 


Resident UNIQUE UNIQUE le 2,016 2,016 
YES 
Transient UNIQUE UNIQUE = TRAN 412 be eae 74 






Unsolicited output UNSOL= YES 2,139 2,139 


ISAM files FILETYPE =ISAM 3,040 Not available 
MIRAM files FILET YPE=DMRAM 3,546 3,938 


DAM files FILETYPE =DAMR Not available 
SAM disk files FILETYPE=SAMD 41 Not available 


SAM tape files (OTF) FILET YPE=SAMT Not available 
Sequential tape files FILET YPE=TMRAM Not available 3,938 


(CDM) 
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Table B—3. Effects of Configurator Options on the Size of a Multithread IMS Load Module (Part 2 of 2) 


Increment in Size (bytes) 


Continuity data area® ACTION CDASIZE=n 
(or UNIQUE used) 
Editing of input EDIT =tablename 3,148 3,148 
messages 
DRCROMGT 


Use of defined record 10,432 10,432 


management (implied 
@ An 1/0 area must also be allocated for the AUDFILE audit file (B.3.5). 
























with UNIQUE) 


4 NOTES: 


@ An I/O area must also be allocated for the TRCFILE trace file (B.3.5). 


8) An I/O area must be allocated for the CONDATA continuity data file (B.3.5). 


B.3.2. Optional Tables and User File DTFs 


Each type of control table generated by IMS has a characteristic size to be used in 


estimating your main storage requirements for multithread IMS. Table B-4 lists these & 
and indicates the factor by which to multiply each. 





Table B-4. Multithread Control Table Sizes 


is Multiply by the 
Table Type Total Size (bytes) 

Terminal control 288 terminals (TERMS=n 

in NETWORK section) 
Transaction control 40 transaction codes 

(TRANSACT sections) 
Action actions 

{ACTION sections) 


Program control programs 
(PROGRAM sections) 
DTFMT file control SAM tape files 


Pe 
. 
. 
ss 


























DTFDA file control DAM files 
OTFMI file control MIRAM files 
DIB leseensro! MIRAM disk files and 


RIB file control sequential tape files 
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B.3.3. Optional Resident Action Programs 


To the total space requirement must be added the size of each action program for 
which you specify RESIDE=YES in the PROGRAM section of your configurator input. 
Furthermore, if the action program is shared code (TYPE=SHR) or serially reusable 
(TYPE=SER), you must round the program size upward to the nearest multiple of the 
basic 512-, 1024-, or 2048-byte main storage segment given protection in your 
hardware configuration. 


B.3.4. Main Storage Pool Calculations 

In multithread IMS, main storage management uses the main storage remaining from the 
end of the second phase (shown in the listing for the configuration link stream) to the 
beginning of the resident action program area for the main storage pool. Some of the 
areas within the main storage pool may be shared by concurrently running threads ~ 
others cannot. 

Unsharable areas include the following: 

m the thread control block; 

m the activation record; and 

m ~=record locks. 

Sharable areas include: 

m loaded action programs with their program control blocks; 

w data definition records; 

m the lexicon area (required for UNIQUE); and 

s = the ISAM file I/O areas. 

The main storage pool must be large enough to handle the requirements of all 
concurrently active actions. To obtain the main storage pool requirement, you must 
calculate the main storage needed for the largest possible thread and multiply the result 
by the number of threads that may be active at one time. The total main storage pool 
requirement is then added to the main storage needed for the IMS coding (Figure B-3) 


to obtain the job region size. 


Figure B-4 provides a schedule for calculating the requirements of the largest possible 
thread. 
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B.3.5. AUDFILE, CONDATA, and TRCFILE I/O Areas 


File 1/O areas must be allocated for the audit file (AUDFILE), the continuity data file 
(CONDATA), and the trace file (TRCFILE) if these are used in your multithread IMS 
system. For the AUDFILE I/O area, use the calculations given in B.2.5 for the 
single-thread AUDCONF audit file. For the trace file, use the calculations given in B.2.6 
for single-thread. 


For the multithread CONDATA file 1/O area, which must be allocated if the CDASIZE 
keyword is specified or if UNIQUE is used, the size is either 1280 bytes (if UNIQUE is 
included) or the number of bytes specified by the MAXCONT keyword parameter, 
whichever is larger. 


Size 


Thread control block | 400 


Size of largest nonresident program for the action 
(MAXSIZE parameter value, rounded to hardware block 
size if not reentrant (TYPE=RNT), + 64 bytes © 


Lexicon (required only for UNIQUE: 416 bytes) eo 


Activation Record @ 


Program information block (PIB) 144 bytes + n@® fo 
Output message area (OMA) 
(for UNIQUE, calculate as: (CHRS/LIN+6) x (LNS/MSG)+16) 
Input message area (IMA) 
(length of message or INSIZE parameter value) 
Work area (WA) 
(for UNIQUE, use 672 bytes) 
Continuity data area (CDA) 
(for UNIQUE, use 1280 bytes) 


Defined record area (DRA) 
(required only if the action accesses a defined file) 


2 x length of ali items specified 


Length of longest identifier 


Length of longest record key re. oul 



























Length of longest record containing primary part 


Length of longest record containing a supplementary part 





Figure B—4. Schedule for Calculating Main Storage Pool Requirements for Largest Thread 
in a Multithread IMS System (Part 1 of 2} 
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Size 
Entry and Remarks (bytes) 


Indexed file |/O area@ 
(length of I/O area, + 12 bytes, for each indexed file accessed by 
this action) 


File locks 
(32 x number of indexed files accessed sequentially by this action) 


Record locks 
(32 bytes for each nonindexed record, 32 bytes + keylength for each 
indexed record updated by this action or transaction) 
























Data definition record 


[ snnerione naw ame 

[sew fsoimeimn annie 

ee 

Named record locks ® fw 
(32 x number of locks required) 

[emo wanemsereacronmeee | 


NOTES: 








@ If this is a UNIQUE action program, MAXSIZE=4152 bytes and TYPE=RNT. 


Figure for each subentry must be rounded up to next multiple of 8 bytes. 


if the action is a shared code COBOL action program. 


If this is a UNIQUE action program, two locks are required; each action requires one lock 


6) Here, rn is the number of decimal bytes specified with the SHRDSIZE keyword parameter 
if it accesses a defined file. 


Allow 3 to 4% for main storage fragmentation. 


Figure B—4. Schedule for Calculating Main Storage Pool Requirements for Largest Thread 
in a Multithread IMS System (Part 2 of 2) 


B.3.6. Storage Requirements for Distributed Data Processing 


The IMS transaction facility, which supports distributed data processing, is included in 
the job region when you specify at least one LOCAP section in the configuration. The 
storage requirement for the transaction facility is 30,000 bytes. In addition, there are 
some fixed table requirements and some variable table requirements that depend on the 
DDPSESS and DDPBUF parameters in the configuration or at start-up. 
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Figure B—5 gives the fixed and variable storage requirements and shows the storage 
calculation assuming the default values DDPSESS=5 and DDPBUF= 1024. 


Reaui : 
Entry and Remarks ay eae 
Fixed code requirements 


Table and stack area requirements 
per session 
2,000 x 5 sessions 





Sample Calculation 
(bytes) 
















2 x DDPBUF 
specification 





Buffer requirements per session 






2x 1024x5 





Figure B-5. Sample Calculation of Main Storage Requirements for Distributed Data Processing 
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Appendix C. Operating Performance of 
IMS under OS/3 


C.1. GENERAL 
This appendix discusses a number of alternatives for ensuring the most. efficient 


performance of IMS under OS/3 and presents general formulas useful in analyzing IMS 
performance. 


C.2. ALTERNATIVES FOR MAXIMIZING IMS PERFORMANCE 


Several alternative actions are available to maximize your system's performance. These 
have to do with: 


= Improving response time through the integrated communications access method 
(ICAM) 


= Formatting the named record (NAMEREC) file 

m Making UNIQUE and user-written action programs permanently resident 

m Using individualized action programs instead of UNIQUE 

m Optimizing the allocation of user data files and system library files 

m= Making a sound choice between the single-thread and multithread options 

m™ Scheduling batch processing and continuous output transactions for off hours 
m Adjusting OS/3 system generation parameters to eliminate unwanted overhead 
= # Carefully selecting configuration options 

= Designing action programs for better performance 

m Reducing I/O in program loading 


® ; 
With most of these alternatives, you must consider the tradeoff between improving 
performance and minimizing main storage requirements. 
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C.2.1. Communications Factors 


A resident or transient version of ICAM may be configured with IMS. In general, you 
can expect an improvement in average time through ICAM by configuring resident ICAM 
instead of transient ICAM, a saving of six I/Os to load three overlays per message (in 
and out). 


The tradeoffs are main storage and I/O contention. Transient ICAM uses overlays to 
execute the polling cycle. The main storage tradeoff is approximately 22K. 


C.2.1.1. Creating Buffer Pools 


To optimize performance and main storage utilization, configure buffers and activity 
request packets (ARPs) as close to actual usage as possible. Use the STAT=YES 
operand on the BUFFERS macro periodically to check usage. However, do not use the 
STAT operand in a production environment because it degrades performance. 


C.2.1.2. Line and Terminal Considerations 


You should consider the following factors when creating your network of lines and 
terminals and defining the LINE and TERM macros in the network definition: 


@ #&ODirect connect lines have faster turnaround time than dialed lines. 


m Line speed has a significant effect on response time. Use the highest line speed 
possible. The greater the load on the line (number of characters per time interval), 
the more important is line speed. 


= Two-way simultaneous transmission (full duplex) lines have faster turnaround than 
two-way alternate transmission. 


m= The order in which lines and terminals are defined affects response time. List the 
most heavily used lines and terminals first. 


= The fewer terminals per line, the better the response time. In moderate-to-heavy 
usage, more than 15 terminals on a line may be excessive. For polled devices, all 
terminals on a line should be in the same poll group. 


= #8 The choice of a polling interval affects response time. 


= IMS does not use terminal statistics, so STATS=YES should not be specified on 
the LINE macro. 


m There are instances, especially when using IMS with screen format services, when 
output messages appear truncated at the remote device. This occurs because the 
line buffer length for each line in the network definition for output messages is not 
large enough to contain the entire output message (no segmentation occurs). 
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To correct this, specify the desired line buffer length in words (one word equals 
four bytes) in the LBL parameter of the LINE macro. There is no maximum for the 
line buffer length, so you can specify a length large enough to accommodate the 
output message. 


C.2.1.3. Disk Queueing Considerations 


You can save main storage by using disk queueing for output messages, but processing 
speed is slower. In an IMS system that supports unsolicted output, three queues per 
terminal are required. Usually, the high- and medium-level queues should be kept in main 
storage for processing speed, and the low-level queue should be kept on disk. Because 
of this requirement, unsolicited output should be configured only if needed. 


Do not specify the VERIFY operand on the DISCFILE macro. This specification results in 
excessive disk I/O during message flow. 


C.2.2. Structure of the NAMEREC File 


IMS uses the facilities of OS/3 data management to load the NAMEREC file during 
pre-online processing with blocks that contain your edit tables, password definition 
records, and data definition records - and again, during the configuration process, when 
certain control tables are generated by the IMSCONF jproc and the configurator and 
loaded into the NAMEREC file. The NAMEREC file is an ISAM file if your system 
operates in DTF mode; it is a MIRAM file if your system operates in CDM mode. Its 
record format is fixed, blocked (RECFORM=FIXBLK), and there is one record per block. 


The efficiency with which IMS may use the NAMEREC file during online processing - an 
important factor in your system’s performance - is affected by the structure of the file: 
by the size and number of the records it contains and the distribution of records in the 
prime data and overflow areas on disk. (For details on the layout of an ISAM file, refer 
to the current version of the data management user guide, UP-8068, or the data 
management programmer reference, UP-8159. For a MIRAM file, see the consolidated 
data management concepts and facilities user guide/programmer reference, UP-8825.) If 
there are too many records in overflow (and the overflow records in a NAMEREC file 
are usually those generated by the data definition processor), performance will be 
degraded. Before this occurs, the NAMEREC file should be reformatted. However, it is 
also advisable to provide sound organization for the NAMEREC file to begin with, by 
carefully considering its parameters before you initialize it for its first pre-online load. 


The block size you specify for the NAMEREC file is completely variable between two 
limits (subject only to the track size of the disk subsystem it uses), ranging between 
1024 and 12,800 bytes. Since your data definition records (if you use them) will be the 
most numerous type of record in this file (and will be the most likely source of records 
in overflow), your calculation should give primary billing to their sizes. 
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In determining block size for the NAMEREC file, a prudent step is to estimate the size of 
the largest data definition record conceivable in your application and to allow a margin 
for the likelihood that you later may require another, larger size. The default block sizes 
(3072 bytes for single-thread systems, 6144 for multithread) may not leave you enough 
margin for the growth your own application may experience. For the formula used in 
calculating the size of a data definition record, refer to Figure B-4. 


The configurator contributes records to the NAMEREC file. If all configuration records 


have the same blocksize, you may use the same NAMEREC file for all your online IMS 
load modules. 


In planning your NAMEREC file, you should ensure that you do not underestimate the 
ultimate size of the file, and you should not specify that it may be extended. If 
automatic extension is requested and occurs, the file may be fragmented on disk. The 
resulting inefficiency in accessing it may well cost you more than having records in 
overflow. 


It is important to specify enough space for a NAMEREC file. (See 4.2.8.) If the number 
of NAMEREC blocks specified is not adequate, one of the following conditions occurs: 


m The message NAMEREC FILE EXHAUSTED appears on the console. 

m The message FILE EXHAUSTED appears on the console. 

= A configurator abnormal termination occurs. 

The default value of 75 blocks allocated by the IMSCONF jproc is adequate for an 
average size configuration; however, larger configurations or multiple configurations 
require more blocks. For example, suppose you intend to configure three IMS load 


modules with the following characteristics (see 4.3.1.2): 


CONFID=1 Contains approximately 20 terminals, 30 files, 30 actions, 30 
programs, and 15 transactions. 


CONFID=2 Contains approximately 11 terminals, 14 files, 12 actions, 17 
programs, and 10 transactions. 


CONFID=3 Contains approximately 9 terminals, 16 files, 13 actions, 13 
programs, and 7 transactions. 


Configuration 1 requires 75 blocks 
Configuration 2 requires 38 blocks 
Configuration 3 requires 38 blocks 


Approximately 151 blocks are required for the three configurations. 
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You can obtain a substantial improvement in performance by periodically reformatting 
the NAMEREC file to eliminate overflow records. A 20% improvement has been 
achieved by logically dumping and restoring the NAMEREC file. The DATA file 
processing utility routine (and the UDD job control procedure) available for reformatting 
an ISAM file during a disk-to-disk copy or comparison run are documented in the data 
utilities user guide/programmer reference, UP-8069 (current version). 


You can also physically delete unwanted data definition and password records by 
executing the NAMEREC file utility with the DELETE function parameter, followed by the 
UDD job control procedure. (See 3.2.4.) 


C.2.3. Permanently Resident Action Programs 


You can improve performance in a single-thread IMS system by making as many action 
programs resident as possible, starting with the most heavily used programs. If UNIQUE 
is frequently used, you should consider making the command interpreter module ZU#CIN 
resident by specifying UNIQUE=RES in the configurator OPTIONS section. 


Program residence is less important in a multithread system because of sticking power, 
an IMS feature that holds frequently referenced programs in main storage. 


C.2.4. UNIQUE and Defined Record Management 


UNIQUE is a general-purpose set of action programs, and you can get better throughput 
and response time with user-written action programs tailored to a particular application. 
Also, the overhead of defined record management reduces performance. However, if 
you do need defined record management, you may make the defined record 
management modules resident (RESIDE=YES in the configurator DRCRDMGT section) 
and thus repeatedly save DRM segment loading time. 


UNIQUE is available as unblocked load modules. To take advantage of the loading 
performance offered by the block loader, however, block any UNIQUE modules that are 
larger than 3,000 bytes. Use the BLK function of the librarian to block the following 
UNIQUE modules: 


= ZU#DSP 
mw ZU#LCA 
= ZU#MDR 
m ZU#PUP 
m ZU#SUP 


Keep a copy of these modules in unblocked form for patching purposes. A patched 
blocked load module is loaded in a degraded mode. If you must take a patch to the 
UNIQUE modules (or any user action program), apply it to the unblocked version, then 
block it again using the librarian. 
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C.2.5. Optimizing File Allocations 


Performance is improved by observing the following rules: 


When allocating disk files, specify the C parameter on the EXT job control 
statement to avoid secondary extent areas. 


Build a separate IMS load library instead of using the system load library. Position 
the file as close as possible to the volume table of contents (VTOC) record of the 
disk volume. 


Position frequently accessed files, data and otherwise, about the middle cylinders 
of a disk to minimize head movement time. 


In general, do not place user data files on the same disk as your IMS load library - 
again, to reduce head movement time. Also, use a separate disk for IMS internal 
files and ICAM files. 


Avoid placing all files on disk subsystems that are available to you only via a single 
channel or disk adapter. 


Compress load libraries and data files periodically to remove deleted modules and 
directory entries. 


Use resident common storage area ISAM files to save disk access. 


For files accessed sequentially most of the time, use multirecord blocks. Files 
usually accessed randomly should be unblocked. 


Nonindexed files are more efficient than indexed files, because references to the 
index area require additional accesses. However, if files must be extended, use 
indexed files. 


C.2.6. Ensuring That the Multithread Option Is Viable 


Only when sufficient main storage can be allocated to run multiple action programs 
concurrently, and the possibility exists for a significant degree of parallel processing, is 
the overhead inherent in multithread operation likely to prove supportable. See C.4 for 
main storage requirements for concurrent processing under multithread IMS. 


C.2.7. Scheduling Batch Processing and Continuous Output Transactions 


Online batch processing conducted during normal production hours when the terminal 
network already has heavy activity may noticeably degrade system performance. If 
offline batch processing is not an acceptable alternative, online batch processing is best 
scheduled so as to least interfere with the day’s normal throughput: during slack 
periods, for example, or just prior to shutdown. 
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Extensive use of continuous output by multiple terminals in a network can affect 
response time at terminals doing interactive processing. Like online batch processing, 
continuous output should be scheduled during off hours. 


C.2.8. Eliminating Unwanted System Overhead 


You can eliminate unwanted overhead by eliminating certain features from your 
operating system. Consider these SYSGEN specifications: 


ERRLOG=NO 


Eliminating error logging can reduce system 1I/O. You can, alternatively, include 
error logging in your supervisor and turn it off via console key-in when you run 
IMS. 


MEMCONSOL =NO 


In a dedicated or nearly dedicated system, main storage consolidation is not 
necessary. 


RESMOD=SM$STXIT,SM$TASK,SMS$ASCKE,SM$ATCH,SM$LOD 


Making these functions resident reduces the number of I/Os. SM$LOD, SM$STXIT, 
and SM$ASCKE are important in both single-thread and multithread IMS; however, 
if you configure the fast load feature, SM$LOD is not necessary. SM$TASK is used 
by ICAM and multithread IMS. SM$ATCH is the least important of the group. If 
these modules cannot be made resident, additional transient areas should be 
allocated. 


ONLNDIAG=NO 


Elimination of online diagnostics reduces the size of the supervisor. You can 
configure a second supervisor with this feature for diagnostic work. 


ROLLOUT =NO 


In a dedicated environment, this feature is never used. In a _ nondedicated 
environment, IMS cannot be rolled out, but significant system |/O to roll out 
another job could affect performance. 


SPOOLING =OUTPUT 
lf a printer can be dedicated to IMS, you can specify SPOOLING=NO. This will 


slow down the execution time of other programs but eliminate large amounts of 
disk I/O. If you cannot dedicate a printer to IMS, specify SPOOLING=OUTPUT. 
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JOBACCT=NO 

Eliminating job accounting reduces the size of the supervisor and the number of 
1/Os. Job accounting may be used to examine the number of accesses to each disk 
drive assigned to IMS as an aid in determining file placement, then eliminated once 
this information is known. 

SYSLOG=NO 

Omitting the system log reduces disk space and I/Os. 


CONSOLOG=NO 


Specification of the console log has significant effect on supervisor size and system 
1/O. If this feature must be included, the maximum buffer size should be generated. 


C.2.9. Configuration Considerations 


The order in which you define the repeatable sections of configurator input affects 
response time. You should define the most heavily used entries first in the FILE, 
TERMINAL, TRANSACT, ACTION, and PROGRAM sections. This reduces table lookup 
time. 


In addition, you can improve performance by carefully choosing or calculating certain 
configurator specifications: 


In the TIMEOUTS section, set both action and status time-outs as high as possible. 
Once your system is debugged, time-outs are seldom needed, and the higher value 
reduces timer interrupts. 


Suppress file tracing (TRACE parameter in the FILE section) for nonessential files, 
and consider recording only before- or after-images for offline recovery (RECOVERY 
parameter in the OPTIONS section). 


Set the AUDITNUM specification as low as possible (GENERAL section). Higher 
settings waste disk space and lead to excessive head movement between file 
partitions. 


For indexed files, include the INDAREA and INDSIZE data management keywords, 
and specify the largest possible value for INDSIZE. This allows part or all of the 
main index to reside in main storage. 
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C.2.10. Designing Action Programs 


The way you design and code action programs has a direct bearing on performance. 
Here are some points to consider: 


m Keep input and output messages to a minimum number of characters. Transmission 
time is a significant factor in response time. 


m= Whenever possible, terminate action programs with immediate internal succession 
instead of delayed internal or external succession. 


m= Consider using external succession instead of delayed internal succession. In 
single-thread IMS, delayed internal succession can prevent the processing of other 
messages for longer periods of time because the successor program is scheduled 
immediately. In multithread IMS, delayed internal succession increases response 
time. 


= Avoid holding record locks any longer than necessary. In multithread IMS, holding 
record locks can lead to a deadlock situation and may inhibit the scheduling of 
messages. In single-thread IMS, messages may be canceled and need to be 
reentered at a later time. 


= Avoid alternating file accesses, unless files are spread over different devices. When 
files are on the same device, this causes excessive head movement. 


C.2.11. Reducing I/O in Action Program Loading 


Action programs larger than 2560 bytes should be blocked, using the BLK control 
statement of the OS/3 librarian. Refer to the system service programs (SSP) user guide, 
UP-8062 (current version). Block load modules increase the efficiency of program 
loading. 


To avoid extra loading operations, do not use patched load modules and do not use 
ALTER statements in the IMS execution job control stream. 


The fast load feature (4.3.3.4) improves performance of action program loading. 


C.3. ANALYZING IMS PERFORMANCE 


Table C-1 provides general timing formulas for estimating the response time for 
transactions processed by IMS. It is not possible to give precisely quantified values for 
each of the component timing factors because of the large variation in user 
environments; e.g., different transaction profiles, different processing requirements, 
different background workloads, and different hardware configurations. Nevertheless, 
analysis of these formulas may help the systems analyst determine which factors are 
critical in his particular IMS environment. 
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Table C-1. General Formulas for Analyzing IMS Performance 


Time to IMS 


Time to IMS = time till poll + time till IMS ready to schedule + system overhead-1 
where: 
Time till poll = 1/2 average poll cycle + line speed + traffic on line 


Time till IMS ready to schedule = response time X number of previous unresponded-to inputs + ICAM 
handling time 
ICAM handling time = execution time + system overhead-1 


System overhead-1 = switcher time + error log time 
Time in IMS = IMS schedule time + user action program time + system overhead-2 
where: 


IMS schedule time = execution time + IMS file 1/7 O time + load time 
IMS file |/O time = channel ready time + head movement time + physical I/O time 
Load time = directory search time + relocation time + system overhead-3 
Directory search time = (channel ready time + head movement + physical 1/O time) X (number 
of blocks till hit) 
Relocation time = (channel ready time + head movement + physical I/O time) X (number of 
blocks in module + relocation blocks) 


System overhead-3 = transient time + switcher time 
Transient time = execution time + wait for area time + transient load time 
Transient load time = channel ready time + head movement + physica! I/O time 


User action program time = execution time + !/O time + output time 
1/O time = execution time + user file [/O time + system overhead-4 
User file |/O time = channel ready time + head movement + physical I/O time 
Output time = execution time + file i/O time 


System overhead-2 = switcher time + error log time 
Error log time = channel ready time + head movement time + physical 1/0 time 


Time to terminal = time till ICAM ready + ICAM handling time + time till line available + system overhead-5 
where: 
Time till line available = traffic on line + line speed 


System overhead-5 = switch time + error log time 





C.4. CONCURRENT PROCESSING UNDER MULTITHREAD IMS 


The following main storage areas must be available for IMS to concurrently schedule 
input Messages under multithread IMS: 


m= One load area for each concurrent action, each load area being large enough to 
accommodate the largest program that action might need 
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NOTE: 


If an action program is serially reusable, input messages using that same action 
program will not be concurrent. If the action program is sharable or reentrant, only 
one load area is necessary for concurrency. 


m= One activation record area for each concurrent action. (Activation record area size 
can be calculated based on user input to the configurator in the ACTION section. 
See 4.3.8). 


NOTE: 


For load areas under serially reusable programs and activation records, the size 
must be rounded up to a hardware protection block size and the area must be 
allocated on appropriate storage boundaries. 


w One I/O area for each ISAM, MIRAM, and SAM file used by any of the concurrent 
actions 


NOTE: 


DAM files do not require an I/O area. For other access methods, only one I/O area 
is required if two or more actions are both accessing the same file. 


w= One thread control block for each concurrent action 


m= One program control block (approximately 50 bytes) for each program in the 
storage pool 


Other areas, such as record locks and NAMEREC records, may be needed. Because 
storage fragmentation takes place, the user should increase by 10 to 20% the storage 
size he calculates. 


C.4.1. Lock-for-Transaction Feature 


If the IMS lock-for-transaction feature is used and retained for an entire sequence during 
transactions that consist of multiple input messages, concurrency is minimized. When 
concurrent actions access the same record and one action imposes a lock, the 
lock-for-transaction feature may cause space in the main storage pool to be allocated 
for actions that are then suspended awaiting the release of some locked record. If this 
occurs, main storage availability decreases, thereby decreasing concurrency possibilities. 


Deadlock occurs when all transactions being processed are waiting for a resource that 
is allocated exclusively to some transaction and no more input messages can be 
scheduled because of insufficient main storage. A deadlock condition can also be 
caused by an action program issuing a GETUP function (read and update) to two 
different files while a second action program is performing the reverse (a write function). 
Therefore, when designing action programs, the user should consider this sequence of 
events. When IMS detects deadlock conditions, it cancels the transaction and rolls back 
the update. 
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C.4.2. Assigning Tasks at IMS Start-up 


You must specify a minimum of four tasks on the JOB statement at start-up of a 
multithread IMS system. IMS attaches one !/O subtask when you specify four tasks and 
one for each additional task. If your application has actions that initiate many logical I/O 
requests (30 or more), you should assign six or seven tasks to IMS. (A specification 
greater than 7 cannot significantly increase throughput and wastes main storage.) If 
your actions use fewer logical |/O requests, you can achieve effective throughput with 
five tasks. 
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Appendix D. 


IMS Component 
Structure 


in this appendix break down the components of single-thread and 


multithread IMS. Figure D-1 shows the overall structure of IMS and the modules used in 
pre-online and offline recovery processing. The components shown with indicators in 
the upper-right corners are expanded in later diagrams. 
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Figure D-1. 
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Figure D-2 shows a detailed breakdown of the IMS configurator modules which the 
IMSCONF job control procedure generates and executes in the 5-step configuration 
process described in Section 4. 
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ZO#CNF10 





COMMON ERROR END OF INPUT 
INITIALIZATION SECTION cROss- PROCESSING 
MODULES PROCESSOR REFERENCING ZO#CNF38 
ZO#CNF16 
ZO#CNF14 ZO#CNF45 
ZO#CNF15 ZO#CNF46 











ead Ne NONFILE ‘NeSrReRia INTERNAL CROSS- 
ASSEMBLY SOURCE seocecsind GENERATION nen prea 
GENERATION 
ZOQ#CNF17 ZO#CNF18 ZO#CNF 41 ZO#CNF40 ZO#CNF39 
ZOQ#CNF 29 ZQ#CNF19 ZO#CNF42 
ZO#CNF30 ZO#CNF20 ZOQ#CNF43 
ZO#CNF31 ZQ#CNF21 ZO#CNF44 
ZO#CNF32 ZQ#CNF22 
ZO#CNF33 ZO#CNF23 
ZO#CNF34 ZO#CNE24 
ZO#CNF35 ZO#CNF25 
ZO#CNF36 ZO#CNF26 
ZOHCNF 37 ZO#CNF27 
ZO#CNF28 
NOTE 


The name of the configurator program for generating a multithread IMS system is ZO#CNFOO. The 
configurator for generating a single-thread IMS system is named ZS#CNFOO. The module names shown at 
tower levels are those for multithread configurations; those for single-thread configurations follow the same 
pattern, the letter “‘S’ -replacing the letter “Q’’, That is, the single-thread configurator module names 











constitute the set ZS#CNFOO through ZSHCNF46. 


Figure D-2. Configurator Modules 
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The data definition processor modules are the same for single-thread and multithread 
IMS, as shown in Figure D-3. 
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INITIATES ID ENVIRONMENT DEFINITION DEFINITION DATA DIVISION PASSWORD PRINT 
ALL INTERNAL SCAN DIVISION DIVISION SYNTAX DEFINITION DIAGNOSTIC 
rie) SCAN ENTRY ANALYSIS RECORDS TO LISTING 
OT3DF001 DT3DF003 DT3D F005 DT3DF009 NAMEREC FILE DT3DFO12 
DT30F007 DT30F011 



























DATA 
INITIATE SCAN DATA ID DATA DIVISION DEFINITION 
LEXICON DIVISION ENVIRONMENT MEMORY REFERENCE 
SCAN SYNTAX MAPPING RESOLVER 

DT3DF002 DT3DF004 | OT3DF006 OT3DF008 OT3DF010 





Figure D-3. Data Definition Processor Modules 


Figure D-4 illustrates the modules used in single-thread IMS online processing. 
Application management, file management, internal message control, and IMS action 
program components are shown in greater detail in Figures D-5 through D-9. Action 
programs are the same for single-thread and multithread IMS. 


ONLINE 


PROCESSING 


INTERNAL 





APPLICATION ACTION 
START-UP MESSAGE SHUTOOWN 
MANAGEMENT CONTROL PROGRAMS 
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MOOULE MODULE MODULE MODULE MODULE MODULE 
ZQ#STRTN ZB#STRIN ZC#MOPEN ZB#SHUTN ZC#SHUTN ZS#STASH 








Figure D-4. Single-thread IMS Online Processing 
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Figure D-5. Single-thread IMS Application Management 
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DMS 
INTERFACE 
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TOMFILE 
PROCESSOR 






OPEN CLOSE 
PROCESSOR 
ZFHOPC 






ZFAITR 


Z2FsTOM 






























SAM 
INTERFACE 
MODULE 
ZF*ISEO 


DamMR 
INTERFACE 
MODULE 
ZFeOAMA 


ISAM 
INTERFACE 
MOOULE 
ZFeISAM 





DEFINED 
RECORD 
MANAGEMENT 


NOTES: 
$ replaces # for COM version of module. 


Available for CDM only 


DRM FAC. 





OOOO 


Available for DTF only REQUIREMENT ORM REQUEST 
ANALYSIS wocescon 
One of the listed versions is linked in for e particular IMS configuration. ZJWSCHOL/ 


ZJNSCHO3/ 
ZJSSCHOM 





Figure D-6. Single-thread IMS File Management 








UP-8364 Rev. 7 


SPERRY UNIVAC OS/3 
IMS SYSTEM SUPPORT FUNCTIONS 











imc 
CONTROL 
MODULE 
ZCHIMCST 


INPUT EDITING 


GENERAL GENERAL 
INPUT EDITING 

MODULE MODULE 
ZcallPp ZCHREAD2 


MASTER 
TERMINAL 
COMMAND MODULE 
ZCHMTCP/ZC#MTCON 


FUNCTION KEY 
MODULE 
ZCAFKEY 





EXPANDED SCREEN 
INPUT EDIT 


MODULE 
ZCHED2 ZCHSFSST 


NOTE: 


@ One of the listed versions is linked in for a particular IMS configuration. 








FORMAT SERVICES 
INTERFACE MODULE 





IMC 
BATCH ICAM 
DECODE 
MODULE 
ZCHICAM 


GLOBAL OUTPUT 
NETWORKING 


DYNAMIC 
SESSION 
PROCESSOR 
ZC#DYNAS 


GENERAL 
OUTPUT 
MODULE 

ZO#OUTPT 


BUFFER UNSOLICITED 
RELEASE 


MODULE 
Z2C#RELBF 





CONTINUOUS 
OUTPUT 
MODULE 

ZO#CONST 


Figure D-7. Single-thread IMS Internal Message Control Processing 
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ACTION 
PROGRAM 
ENVIRONMENT 


ACTION 
ACTIVATION PROGRAM 
RECORD LOAD 
MODULE 





PROGRAM INPUT eon ACTION IMS 
INFORMATION MESSAGE mm PROGRAM INTERFACE 
BLOCK AREA SOURCE MODULE 
(PIB) (IMA) (WA) BAL/COBOL/APGII ZFHLINK 





DEFINED 


OUTPUT CONTINUITY RECORD 


MESSAGE AREA DATA AREA 


(OMA) (CDA) AREA 


{DRA) 





NOTE: 


@ Optional area depending on configuration 


Figure D-8. Action Program Environment 
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MS 
SUPPLIED 


PROGRAMS 


DOWNLINE AUDIT TRAIL MESSAGE OUTPUT PHYSICAL PHYSICAL 
LOAD REC. PROGRAM SWITCH MESSAGE FILE OPEN FILE CLOSE 
PROGRAM ZSHROL/ZU#ROL SWTCHS/SWITCH REC. PROGRAM PROGRAM PROGRAM 


ZUKLOD ZS4TOM/ZU#TOM ZS#OPE/ZUNOPE ZCHCLS/ZUACLS 


STATISTICAL 
PROCESSING 


LIST 
SELECTION DISPLAY COMMAND MORE COMMAND ZSTAT COMMAND ERROR 
PROGRAM PROGRAM PROGRAM PROGRAM PROCESSING 


Zus#DSP R PROGRAM 
ZU#BSA UND: ZuNMO! ZCABEG Oeeink 


PERFORM UPDATE SHOW COMMAND FILE STATISTICS 
PROGRAM PROGRAM PROGRAM 
Zu#PUP ZU#SHO ZCHFLE 





TERMINAL 


UST AND DETAIL 
OPEN COMMANO START UPDATE STATISTICS 


COMMAND PROGRAM PROGRAM 


PROGRAM 
ZUHLCA ZU#OPN ZuU#SUP 


PROGRAM 
ZC#TER 





NOTE: 


@ Single-thread and muitithread versions 


Figure D-9. IMS-Supplied Action Programs 
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Figure D-10 illustrates the components used in multithread IMS online processing. 
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Figure D~11 illustrates multithread application management modules in detail. 


IMS DOP 
TRANSACTION 


FACILITY 


CONFIGURATI 
START-UP 
MODULE 

ZQ#START 





ION 


START-UP 


APPLICATION 


MANAGEMENT 





A/M IMc 
START-UP START-UP 
MODULE MODULE 
ZB#START ZCHMOPMT 





ONLINE 
PROCESSING 


INTERNAL 
MESSAGE SHUTDOWN 


CONTROL 


ACTION 


PROGRAMS 





SHUTDOWN STATISTICAL 
MODULE SHUTDOWN 


ZT#SHOWN * MODULE 
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Figure D—10, Multithread IMS Online Processing 
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Figure D—11. Multithread IMS Application Management 
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Figures D-12, D—13, and D—14 illustrate the component breakdown of file management, 
internal message control, and distributed data processing for multithread IMS. 
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Figure D-12. Multithread IMS File Management 
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Figure D-13. Multithread IMS Internal Message Control Processing 
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Figure D—14. Distributed Data Processing 
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Figure D—15 illustrates the control modules for the single-thread and multithread batch 
transaction processor. 
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Figure D-15. Batch Transaction Processor Control Modules 
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Appendix E. UNIQUE Language 
Elements 


This appendix lists the language elements in the standard UNIQUE lexicon and the 
maximum number of characters for replacement words. You can replace any or all of 
the language elements in the table by including them in a LANGUAGE section of the IMS 
configuration (4.3.10). 


Table E-1. UNIQUE Language Elements (Part 1 of 3) 


UNIQUE Language Maximum Length of 
Element Optional Replacement 


OPEN 
CLOSE 
DISPLAY 
LIST 
MORE 
DETAIL 
NEXT 
CHANGE 
ADD 
DELETE 


ASSIGN 
SHOW 
CANCEL 
OK 

AND 


NNNYMNHYONHNHAP HH WADWDADADWDADWDDWDADDMDAAWDA 
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E-2 





Table E-1. UNIQUE Language Elements (Part 2 of 3) 


UNIQUE Language Maximum Length of 
Element Optional Replacement 


TOTAL 
COUNT 
MAX 
MIN 
AVG 
FOR 
FROM 
AFTER 
IF 

AT 
COMPLETE 
END 

NO 
PASSWORD 
INVALID 
ILLEGAL 
COMMAND 
MESSAGE 
RECORD 
TOOBIG 
IDENT. 

EOM 
DATATYPE 
1/0 

ERROR 

BAD 

DATA 
EXISTS 
ARITH. 
EXPRESS. 
INPUT 
WORD 
LEXICON 
COMPOSED 
ITEM 

NAME 
FOUND 
STATIST. 
FUNCTION 
ARGUMENT 
MISSING 
ALLOWED 
TOO 

LONG 
EXCEEDS 
PAGE 
UNRECOG. 
REQUEST 
FILE 
CLOSED 
UNDEFINE 























































WDDWDHWODDADADAWDWDWADADWDADADADADAADAADADAMDADAMDADDADDWADADDADDDDDDADADANDAAA © 
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Table E~1. UNIQUE Language Elements (Part 3 of 3) 
UNIQUE Language Maximum Length of 
Element Optional Replacement 


RESPONSE 
CANCELED 
DEFINED 
HAS 
CHANGED 
LITERAL 
OPERAND 
MANY 
START 
RELATION 
LOGICAL 
OPERATOR 
USAGE 
PAREN. 
ZERO 
NUMERIC 
DIGIT 

FEW 

LESS 
THAN 
SINGLE 
VALUE 
LOWER 
BOUND 
LATE 
INCOMPL. 





oo 






























WDDDWDDWDMDDADDADDDWDMDADADADMDMDDWDWDOAMA®D OO 
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Appendix F. IMS Messages 


The tables in this appendix list groups of IMS messages relevant to the topics 
discussed in this manual. They show the text of each message, along with the reason 
why the message was displayed and the action IMS takes or the corrective action you 
should take. 


Table F-1. NAMEREC Utility Diagnostic Messages (Part 1 of 2) 


1ST CARD MUST HAVE Parameter PASSWORD missing in Correct and resubmit. 
PASSWORD COLS. 1-8 columns 1-8. 















COL 1 IN CONTINUATION A character appears in column 1 of a Correct and resubmit. 
CARD MUST BE BLANK continuation card. 
CONTINUATION EXPECTED A character appears in column Correct and resubmit. 
- NOT FOUND 1 of a continuation card. 
KEYWORD PID= MISSING Keyword parameter PID was omitted. Include missing parameter and 
resubmit. 






KEYWORD DDN= MISSING Keyword parameter DDN was omitted. | Include missing parameter and 
resubmit. 

Keyword parameter FN was omitted Include missing parameter and 
resubmit. 

KEYWORD TID= MISSING Keyword parameter TID was omitted. Include missing parameter and 
resubmit. 


PARAMETER ERROR - NAME The name of the specified record 
IGNORED contains more than seven characters, 
spaces or commas were used in- 
correctly, or necessary commas were 
omitted. 


PASSWORD ALREADY IN FILE Duplicate password. 
PASSWORD ppppppp IS A mandatory parameter omitted in Include missing parameter and 
INCOMPLETE definition for password ppppppp. resubmit. 


PASSWORD  rreeer A password previously prepared 
RESTORED TO FILE for deletion has been restored 
to the file. 






KEYWORD FN= MISSING 










Correct and resubmit. 













UP-8364 Rev. 7 





SPERRY UNIVAC OS/3 


F-2 


IMS SYSTEM SUPPORT FUNCTIONS 





Table F-1. 


ppppppp ISAM 
UNRECOVERABLE ERROR 


ppppppp OVERFLOW AREA 
1S FULL 


rrrerrer NOT FOUND 


NAMEREC Utility Diagnostic Messages (Part 2 of 2) 


An unrecoverable device error oc- 
curred while adding password defini- 
tion record for password ppppppp to 


_the named record (NAMEREC) file. 


The definition of this and all following 
passwords is not processed. 


Overflow area for NAMEREC file is 
full, preventing addition of password 
definition record for password 


PPPPPPP. 


The record specified for deletion 
does not exist. 


NAMEREC file is compromised 
and problem must be cor- 
rected. NAMEREC file must be 
reinitialized, and ail pre-online 
processors must be rerun. 


Reorganize NAMEREC file. 
NAMEREC file must be reiniti- 
alized, and all pre-online pro- 
cessors must be rerun. 


Check job control contents of 
NAMEREC file to determine 





if correct name was specified. 


rrererr ALREADY PREPARED 
FOR DELETION 


The record specified was already 
marked for future deletion. 


rrrrerr PREPARED FOR 
PHYSICAL DELETION 


The specified record was found 
and successfully marked for 
deletion. 








Table F-2. Configurator Errors and Their Interpretation (Part 1 of 7) 


Diagnostic Message Message Description Configurator Action 


Error Code 1 — Initialization Errors 


“**FRROR O1 01 NO SOURCE LINES, An end-of-file was found try- No further processing is 
ing to read the first input done; program is termi- 


record. nated. 


FILE IS EMPTY 
The configurator input has to 
Start with a section card 
(NETWORK if present). Sec- 
tion name must appear in co- 
lumns 1 through 8 on the 
section cards. The configura- 
tor searches for the first card 
(record) with a nonblank char- 


*** ERROR 01 02 FIRST CARD IS NOT A 
SECTION CARD 
acter in column 1. 


*** ERROR O01 03 NO SECTION CARDS, No cards with a nonblank in No further processing is 
EOF FOUND column 1 were found. done; program is termi- 
nated. 
*** ERROR 01 04 NO SECTION CARDS 
AFTER NETWORK 
SECTION 


Disregards all input until a 
section card is found. 





No sections were found after 
the NETWORK section. This is 


No further processing is 
done; program is termi- 
not enough information to nated. 

produce a full configuration. 








@ “** ERROR 02 02 
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Table F-2. Configurator Errors and Their Interpretation (Part 2 of 7) 


Diagnostic Message Message Description Configurator Action 


Error Code 1 — Initialization Errors (cont) 





*** ERROR 01 05 CCA LOADING ERROR 


TERMS= 1 ASSUMED 


1. CCA load module, generated in} Configuration processing 
the CCA link step of IMSCONF]| continues. The number of 


jproc and specified by the 
NAME parameter in the 
NETWORK section, could not 
be found in the load library. 


. Insufficient main storage to 


terminals is defaulted to 1. 
This allows the configurator 
to complete and to check 
for other error conditions. 
See console error message 
also displayed. 


load CCA load module. 

3. CCA has zero length. 

4. Locap name specified in the 
CUP parameter of the 
NETWORK section was not 
found in the loaded CCA. 


Error Code 2 -— Section Errors 
















SECTION APPEARED 
BEFORE 













All repeated sections must be 
input consecutively. 


Input is ignored until 
another valid section is 
encountered. 


*** ERROR 02 01 






INVALID SECTION 
NAME 






Section name input does not 
match a valid section name. 


Input is ignored until 
another valid section is 
encountered. 





*** ERROR 02 03 


*** ERROR O02 04 


“** ERROR O2 05 


“** ERROR 02 06 


*** ERROR 03 01 


SECTION NAME TOO Section name found to be 
LONG longer than 8 characters. 


Input is ignored until 
another valid section is 
encountered. 


























THIS SECTION CANNOT 
REPEAT 


A nonrepeatable section was 
repeated. 


Input is ignored until the 
next valid section is en- 
countered. 















TERMINAL SECTION 
COUNT EXCEEDS 
‘TERMS =" 


TERMS=n specification in the 
NETWORK section is less than 
the number of TERMINAL 

sections input to the configurator. 


Input is ignored until 
another valid section is 
encountered. 














INVALID LOCAP 
NAME 









The locap name is the same 
name specified in the CUP 
parameter of the NETWORK 
section. 


Input is ignored until 
another valid section is 
encountered. 








Error Code 3 — Syntax Errors 


PARAM WORD 
REQUIRED AND NOT 


All repeatable sections re- 
quire a parameter word 


This parameter word is es- 
sential to process the sec- 
tion. When this error oc- 
curs, the input is ignored 
until another valid section 
is encountered. 


FOUND immediately following the 


section name. 
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Table F-2. Configurator Errors and Their Interpretation (Part 3 of 7) 


Diagnostic Message Message Description Configurator Action 


Error Code 3 - Syntax Errors (cont) 


*** ERROR 03 02 KEYWORD DOES NOT All keywords for all sections Scanning on the input re- 
END IN AN = SYMBOL must end in equal sign. with cord continues until a | 
no space between the word nonblank character is en- 

and the equal sign. countered. 


*** ERROR 03 03 INVALID KEYWORD Keyword input {i.e., a word Input is ignored until the 
FOR CURRENT in length to 8 characters and next valid keyword for this 
SECTION terminating in an equal sign) section is encountered. 
does not match any keyword 
for current section. 





*** ERROR 03 04 TOO MANY CHAR IN All positional parameters and When positional parameter 
PWORD/KEYWORD keyword specifications must is too long, input is 
SPEC be 8 characters or less in ignored until the next 
length. valid section. When keyword 
specification is too long, 
the default value for the 
keyword is assumed. 


*** ERROR 03 05 KEYWORD INPUT Self-explanatory. The latest value for that 
MORE THAN ONCE keyword is accepted. 





*** ERROR 03 06 INVALID CHAR An invalid character was When invalid character 

PARAM/KEYWORD found in the positional is in positional parameter, 

SPECIFICATION parameter or keyword input is ignored until the 
specifications. Refer to next valid section. When 
assembler user guide, UP-8061 invalid character is in 
(current version), for keyword specification, the 
explanation of errors in input scan continues. 
assembly listing. 


*** ERROR 03 07 PARAM WORD MUST First character of parameter Input is ignored until 
BEGIN WITH ALPHA was nonalphabetic. another valid section is 
CHAR encountered. 
*** ERROR 03 08 PARAM WORD Parameter specification con- Value is truncated to maxi- 
TRUNCATED TO tains too many characters. mum allowable length. 
MAXIMUM LENGTH 
“** ERROR 03 09 PARAM WORD Reserved word was specified Input is ignored until 
RESERVED for transaction code. See another valid section is 
Appendix A. encountered. 
*** ERROR 03 11 LOCAP NAME Locap name is the same as Input is ignored until 
INVALID specified in CUP keyword param-| another valid section is 
eter in the NETWORK section. encountered. 
*** ERROR 03 12 DUPLICATE Transaction code/lexicon Input is ignored until 
TRANSACTION/ name was previously specified. another valid section is 
LANGUAGE NAME encountered. 
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Table F-2. Configurator Errors and Their interpretation (Part 4 of 7) 


Diagnostic Message Message Description Configurator Action 


Error Code 4 — Semantic Errors 






















“** ERROR 04 01 INPUT ERROR - 


DEFAULT ASSUMED 


*** ERROR 04 02 MISSING REQUIRED FILE section requires some 
KEYWORD FOR THIS keywords. 
SECTION 

*** ERROR 04 03 KEYWORD PARAM Response to LOCK keyword LOCK=TR is assumed. 
MUST BE ‘UP’ OR ‘TR’ must be either ‘UP’ or ‘TR’. 

*** ERROR 04 04 


*** ERROR 04 05 


*** ERROR 04 06 


*** ERROR 04 07 
“** ERROR 04 08 


*** ERROR 04 09 


All keywords have stan- 
dard defaults that are 
printed when the C option 
of the LST keyword par- 
ameter of the IMSCONF 
jproc is specified. 


Self-explanatory. 






















Standard default is as- 
sumed. 































KEYWORD PARAM 
MUST BE Y(ES) OR 
N(O) 


Valid response for this key- The default specification is 
word is Y or N, or YES or NO. assumed. 


















KEYWORD PARAM 
MUST BE A DECIMAL 
NUMBER 

















Response to this keyword 
must be a decimal number. 
One or more characters are 
not O to 9 EBCDIC characters. 


An asterisk is placed in 
the exact location and a 
default of zero is as- 
sumed; e.g., an input of 
12A30 with an invalid 
third character results in 
12°30 if the C option is 
specified and 12030 is left 
to default. 
















KEYWORD PARAM 
MUST BE A HEX 
NUMBER 





Response to this keyword par- 
ameter must be a hexadeci- 
mal number (input was in 
EBCDIC). 


Action is same as 04 05 
error but valid characters 
are O through F. Error re- 
porting and default are the 
same; e.g., 12A will ap- 

pear 12AF*O and default 

12AFOO. 









































INCONSISTENT WITH 
PROC= SPECIFICATION 


In the FILE section, a required 
keyword was omitted with 
PROC=KEY, or an invalid key- 
word was specified with 
PROC=UNK. 


Configurator generates de- 
fault when PROC=KEY, ig- 
nores invalid keyword 

when PROC=UNK. 










VALUE IS LESS THAN 
THE MINIMUM 
ALLOWED 






Value specified is less than 
minimum allowed. 


Default value for keyword 
is assumed. 

























INVALID KEYWORD 
PARAM ~- DEFAULT 
ASSUMED 


. An invalid keyword speci- 
fication was input when 

other keyword specifications 
are required. 


Defauit specification is 
assumed. 













. Parentheses missing when 
keyword has subparameters. 





. Invalid FILETYPE keyword 
specification in relation to 
CDM parameter in IMSCONF 


jproc. 
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Table F-2. Configurator Errors and Their Interpretation (Part 5 of 7) 


Diagnostic Message Message Description Configurator Action 


Error Code 4 - Semantic Errors (cont) 





*** ERROR 04 10 INBUFSIZ LESS THAN 


‘STAN’ 


*** ERROR 04 11 VALUE GREATER THAN 


THE MAXIMUM ALLOWED 


SPECIFICATION IGNORED - 
SFS NOT SPECIFIED 


UNDEF SPECIFIED 
PREVIOUSLY AND 
ACCEPTED 


*** ERROR 04 12 


*** ERROR 04 13 


KEYWORD PARAMETER 
TRUNCATED TO 
MAX LENGTH 


*** ERROR 04 14 


“** ERROR 04 15 KEYWORD PARAMETER 
MUST EQUAL LANGUAGE 
ID 

*** ERROR 04 16 NON CDM SUPERVISOR - 


DEFAULT ASSUMED 


The INSIZE=STAN or 
OUTSIZE=STAN specification 
under the ACTION section is 
marked in error when the 
INBUFSIZ specification is less 
than the size of a standard 
input or output message. 


The value specified exceeds the 


maximum value allowed. 


RESFMT specification is invalid 
when SFS=NO. 


UNDEF=YES is allowed for only 


one transaction code. 


Too many characters specified in 


lexicon element specification. 


The OPEN lexicon element speci- 


fication must equal the lexicon 
name. 


Operating system is not 
generated with CDM. 


Error Code 5 - File Errors 


“** ERROR O05 01 


*** ERROR 05 02 FILETYPE KEYWORD 


NOT SPECIFIED 
*** ERROR 05 04 INVALID FILETYPE 
OR INCORRECT 
SEQUENCE 


INVALID FILE NAME 


*** ERROR O5 05 


Self-explanatory. 


Invalid file type specification 
in relation to CDM specification 
in IMSCONF jproc. 


In the ACTION section, when 
parameters (i.e., file names) 
are input for the FILES key- 
word, these file names must 
be input consecutively and be 
separated by commas. For ex- 
ample, FILES=file1, file2, 
file3. This error also is caused 
by a file name longer than 7 
characters. 








If not corrected, an insuffi- 
cient staging buffer size 
condition may result dur- 
ing online processing. 


The value defaults to the 
maximum allowed for this 
keyword specification. 


Default is assumed. 


Keyword specification is 
ignored. 


Specification is truncated 
to maximum number of char- 
acters allowed. 


Specification is defaulted 
to the lexicon name. 





SFS specification is de- 
faulted to NO. 


FILE NAME SPECIFIED File name specified is an IMS Input is ignored until the 
IS RESERVED internal file. See Appendix A. next valid section. 


Input is ignored until 
the next valid section. 


Input is ignored until 
the next valid section. 


Scan for next word. Drop 
the input record. 
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Table F-2. Configurator Errors and Their Interpretation (Part 6 of 7) 


Diagnostic Message Message Description Configurator Action 
Error Code 5 - File Errors (cont) 


*** ERROR O5 06 FILE SECTION NOT In the ACTION section, a file Name is dropped, but pro- 
INPUT FOR THIS NAME name parameter specification cessing of file name param- 
on the FILES keyword does eters continues. 
not match any of the file 
names previously input in a 
FILE section. 


“** ERROR OS 07 LINK MODULE FOR Configurator error. A module Module will not be in- 
FILE TYPE NOT FOUND name was not found. cluded. 


*** ERROR O05 08 MAX NMBR FILES The maximum number of files Processing continues, but 
EXCEEDED - NO allowed is 123 for single-thread | file cannot be accessed 
FILE BIT and 240 for multithread. by any action program. 


Error Code 6 - Terminal Errors _ 
*** ERROR 06 04 


*** ERROR 07 02 
“** ERROR 07 03 


*** ERROR 07 04 







































































MORE THAN ONE 
MASTER - FIRST ONE 
ACCEPTED 


Too many master terminals 
are identified. 


Configurator accepts 
the first identified 

terminal as the 
master terminal. 








Error Code 7 — Cross Condition Errors 



















CDASIZE GT MAXCONT 
VALUE 





CDASIZE parameter for any 
action greater than MAX- 

CONT value indicated in the 
GENERAL section. 


CDASIZE is set to MAX- 
CONT value. 

















RECOVERY INVALID 
WHEN FUPDATE=NO 


RECOVERY= was specified, 
but file updating was not con- 
figured. 










No trace file is generated. 








AUDITNUM INVALID 
WHEN NO FUPDATE 
OR LOCK=TR 







The AUDITNUM specification 
is invalid if FUPDATE=NO or 
if LOCK=TR is not specified. 


The audit file is initialized, 
and the DTF/CDIB is gen- 
erated. 
























ACTION SECTION OR 
UNIQUE = YES 
REQUIRED 


UNIQUE=YES or TRAN is re- 
quired if ACTION section is 
omitted. 














*** ERROR 07 05 
*** ERROR O07 06 


PROGRAM SECTION UNIQUE=YES or TRAN is re- 
OR UNIQUE= YES quired if PROGRAM section is 












REQUIRED omitted. 

*** ERROR O7 07 TRANSACTION UNIQUE=YES or TRAN is re- 
SECTION OR quired if TRANSACT section 
UNIQUE = YES is omitted. 
REQUIRED 















NO USER FILES, 
FUPDATE/RECOVERY 
INVALID 


FUPDATE and RECOVERY 
have been specified, but no 
FILE section is included for a 
DAM, ISAM, or MIRAM 

file. 


FUPDATE/RECOVERY fea- 
tures are ignored. 







“** ERROR O07 08 
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Table F-2. Configurator Errors and Their Interpretation (Part 7 of 7) 


Diagnostic Message Message Description Configurator Action 


Error Code 7 - Cross Condition Errors (cont) 
*** ERROR 07 09 


*** ERROR 07 10 
*** ERROR 07 11 
Error Code 8 — Address Resolution Errors 


“** ERROR 08 01 NO PROGRAM FOUND The ACTION section must Relative address is not re- 
FOR ACTION NAME match one program name; solved. 
i.e., one PROGRAM section 
has to be input for each AC- 
TION section. 
*** ERROR 08 02 NO ACTION FOUND No ACTION program name Relative address is not re- 
FOR THIS was found for this TRANSACT solved. 
TRANSACTION section. 
SECTION 
*** ERROR O08 03 NO LOCAP FOUND No valid LOCAP section with None. At online IMS execu- 
FOR THIS TRANS- this locap name was processed tion, transaction will abort. 
ACTION SECTION by the configurator. 






































USER SPECIFIED 
PROGRAMS/ACTION 
MISMATCH 


Action or program name is 
misspelled or missing; or pro- 
gram is not listed in ACTION 
section because it is accessed 
by internal succession or is a 
subprogram. 


None. Unpaired program 
can be accessed only via 
internal succession or as a 
subprogram. 
























NO MASTER 
TERMINAL - USE 
CONSOLE 


No master terminal was spec- 
ified. 


The system console is 
generated as the master 
terminal. 


















OPCOM= YES 
IGNORED - MASTER 
TERM NOT SPEC 


OPCOM=YES valid only when 
a master terminal is 
specified. 


System console is gen- 
erated as the master 
terminal, and OPCOM 
specification is defaulted 
to NO. 
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& : Table F-3. Batch Transaction Processor (BTP} Diagnostic Messages (Part 1 of 2) 


Message Text Description or Cause Corrective Action 


BATCH INPUT MODULE 
READ ERROR 


INVALID BATCH PARAM 
CARD 


PRINTER FILE ERROR 


BTP attempts to access a Check that module name is correct and 
non-existent input module; or an {/O that input messages are indeed present. 
error has occurred; or the module Otherwise, action as for hardware error. 
contains no input messages. 


The control stream contains an Correct the PARAM card. 
incorrect PARAM card. 


This message is sent to the master Check that the file exists and that the 
terminal when a printer file cannot be LFD-name is correct. Otherwise, action as 
opened or an unrecoverable for hardware error. 

hardware error occurs. 


READING SOURCE MODULE |This message is printed upon 


module-name FROM FILE 
file-name 


SOURCE MODULE 


module-name IN FILE 
file-name NOT FOUND 


READ ERROR ON MODULE 
module-name FILE fite-name 


TOO MANY 
@ CONTINUATION CARDS 


HEX CHARACTER ERROR 


HEX CHARACTER PAIRS 
INCOMPLETE 


BATCH NOT CONFIGURED 
~ COMMAND IGNORED 


BATCH=NO SPECIFIED IN 


successfully opening the source input 
module file. 


This message is printed if the batch Ensure that the source module exists in the 
input module is not in the library file. file. 


An 1/0 error occurs while the BTP is As for hardware error 

reading the batch input module. 

The BTP has encountered more than Restrict each input message to the 
17 continuation cards. maximum number of cards - 17. 


The BTP prints this message to the Revise coding between 71 shift characters 


right of the input card image when to represent hexadecimal codes; see 6.4.2. 
an EBCDIC character other than 0-9 


or A-F is coded between two 71 
input shift characters. 


The BTP prints this message to the Revise coding between 7 shift characters 
right of the input card image when to represent hexadecimal pairs; see 6.4.2. 
the EBCDIC characters coded 

between two 71 shift characters are 

within the set O-9 or A-F but are 

odd in number. 


Output to master terminal in If batch processing of transactions is 
response to a ZZBTH command intended, specify the BATCH keyword to 
entered when BATCH=NO is the IMS configurator. 

specified or the BATCH keyword is 

omitted from the NETWORK section 

of input to IMS configurator. 


Output to master terminal in Specify the intended PARAM BA statement 


PARAM CARD - COMMAND |response to a ZZBTH command in the IMS run stream. 


IGNORED 


entered when batch processing is 
configured but the PARAM BA 

statement is omitted from the IMS 
run stream or PARAM BA=NO is 


specified. 
INVALID ZZBTH Output to master terminal in Reenter ZZBTH command with valid 
r PARAMETERS - COMMAND jresponse to a ZZBTH command parameters. 


IGNORED 


entered with incorrect parameters 
(syntax error). 
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Table F-3. Batch Transaction Processor (BTP) Diagnostic Messages (Part 2 of 2) 


TOO MANY ZZBTH 
COMMANDS ENTERED - 
COMMAND IGNORED 


Output to master terminal in 
response to a ZZBTH command 
entered in excess of the number 
which may be processed at one time 
in this configuration. In a 
single-thread IMS system, only one 
ZZBTH command may be active at 
one time. In multithread, the number 
of commands is limited by the 
maximum number specified with the 
BATCH configurator keyword. 


BATCH PROCESSING 
CANCELLED 


Normal response to successful 
ZZBTH CANCEL command; only the 
batch processing currently in 
progress terminates. 


ALREADY READING 
BATCH CONTROL STREAM 
DATA SET - COMMAND 
IGNORED 


Output to master terminal in 
response to a ZZBTH command 
entered before the processing of a 
data set in the control stream has 
been completed by the current 
ZZBTH command. Only one data set 
may be processed at a time; while 
one is being processed, no further 
PARAM IN statements may be 
processed. 


Defer reentry of the ZZBTH command until 
response to the ZZTCT command indicates 
that processing is again possible. 


None required. Batch processing may be 
reinitiated during this execution of IMS by 
entering an appropriate ZZBTH command. 


Defer reentry of the ZZBTH command until 
response to a ZZTCT command indicates 
that the current processing of a control 
stream data set is complete. 


BATCH RESUMED Normal response to successful None required. 
ZZBTH RESUME command. 


BATCH INITIATED 


Normal response to successful start 
of batch processing with the ZZBTH 
command. 


ZZBTH PARAMETER 
PROCESSING ERROR 


Output to master terminal in 
response to a ZZBTH command 
when an input module is missing, the 
end of control stream input is 
accessed, and so forth. 


BATCH PROCESSOR NOT 
IN PAUSE - COMMAND 
IGNORED 


Output to master terminal in 
response to a ZZBTH RESUME 
command entered when the BTP is 
not in a pause state. 


BATCH PROCESSOR NOT 
RUNNING ~ COMMAND 
IGNORED 


Output to master terminal in 
response to a ZZBTH PAUSE or 
ZZBTH CANCEL command when the 
BTP is not running or has completed 
processing. 


BATCH PROCESSOR IN 
PAUSE STATE 


Normal response to a successful 
entry of the ZZBTH PAUSE 
command. 


None required. 


Check for correct parameter information 
and reissue command. 


Do not reenter ZZBTH RESUME command 
until receipt of normal response to ZZBTH 
PAUSE command. 


None required. 


None required. The only valid commands 
following the ZZBTH PAUSE commands 
are the ZZBTH RESUME or the ZZBTH 
CANCEL command. 
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Term 


ACTION configurator parameters 
TIMEOUTS section 
TRANSACT section 


Action programs 
environment 
first for action 
IMS supplied 
largest nonresident 
main storage pool 


modifying action programs 
in the LOPFILE 

naming to configurator 

performance considerations 

reentrance 


residence 
return of control on error 
reusability 
sharability 
timing out 


ACTION section, configurator input 

ALLRNT configurator parameter 

ALTER job control statement 
configurator input procedure 
reading 

ALTER parameter, IMSCONF jproc 

Application management modules 
multithread 


single-thread 


Assembly step, configuration process 


Reference 


4.3.4.1 
4.3.7.2 


Figure D-8 
4.3.8.1 
Figure D-9 
43.811 
B.2.4 

B.3.4 


5.3.3 

4.3.9.1 
C.2.10 
4.3.8.2 
4.3.9.5 
4.3.9.3 
4.3.9.2 
4.3.9.5 
4.3.9.5 
4.3.4.1 


4.3.8 
4.3.8.2 
4.1.1 
4.2.11 
4.2.11 
Fig. D-11 
Fig. D-5 


41 
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Page 


4-99 
4-99 
4-67 


D-8 
D-4 


4-2 


Term 


AUDCONF 


AUDFILE 


Audit file 
allocating at configuration 
assignment at IMS start-up 
AUDCONF (single-thread) 
AUDFILE (multithread) 
AUDITNUM configurator parameter 
cylinder allocation 
initializing at configuration 
1/0 area size 
reinitializing at start-up 


AUDITNUM configurator parameter 


Automatic status messages 


Backward recovery 
BASIC configurator parameter 
BATCH configurator parameter 


BATCH parameter, IMS start-up 


Index 1 


index 


Reference Page 


See audit file and 
continuity data file. 


See audit file. 
428 4-23 
5.3.2 5-8 
4.1.2 4-7 
4.1.2 4-7 
43.2.1 4-51 
4.2.9 4-28 
4.2.9 4-26 
B.2.5 B-7 
§.3.1.1 5-4 
43.2.1 4-51 
4.3.4.2 4-68 
7.4.1.2 7-8 
4.3.3.1 4-57 
43.1.1 4-46 
5.3.1.7 5-8 
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Term 


Batch transaction processor 
configuring 
continuous output 
control streams 
diagnostic messages 
DICE characters 
effect of configurator options 
embedded source data 
initiating at start-up 
input files 
input messages 
main storage requirements 


offline mode 

online mode 

output 

parameter statements 
print files 

recovery 


BLKSIZE parameter, NAMEREC utility 


Block size 
continuity data file 
named record file 


trace file 


Buffer size 
audit file 
continuity data file 
resident ICAM 
trace file 
transient ICAM 


BUFFERS macro 
resident ICAM 
transient ICAM 


BYPASS configurator parameter 


Reference 


43.2.5 
3.2.1 
4.2.9 
7.2.3 


B.2.5 
B.3.5 
2.3.2 
B.2.6 
2.3.1 


2.3.2 
2.3.1 


4.3.8.3 
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Term 


CAFILE configurator parameter 
Catastrophic failure, recovering from 
CC job control statement 


CCA 


CCA linkage step, configuration process 


CCA macro 

resident ICAM 

transient ICAM 
CCA parameter, IMSCONF jproc 
CDASIZE configurator parameter 
CDM parameter, IMSCONF jproc 
CDM mode 

configuring 

description 
CHRS/LIN configurator parameter 
Clean start-up 
Closing trace file 

disk 

tape 
CNFICS parameter, IMSCONF jproc 
COBOL action programs 


Coding rules 


COLD startup 


Index 2 


Reference Page 


4.3.5.3 4-70 
74 7-7 
5.2 5-1 


See communications 
control area. 


41 4-1 
2.3.2 2-10 
2.3.1 2-7 
4.27 4-22 
4.3.8.4 4-89 
4.24 4-20 
4.2.4 4-20 
14 1-7 
4.3.2.2 4-52 
5.3.1.1 5-4 
5.3.1.2 5-9 
7.4.3 7-21 
4.26 4-2] 
4.3.8.14 4-96 
Appendix A 

5.3.1.1 5-4 
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Term 


Common storage area files 
configuring 
main storage requirements 


Communications adapter 


Communications control area (CCA) 
identifying object module 
linking to configurator 


Communications network 
definition 
distributed data processing 
global 
performance considerations 
resident 
supporting multiple programs 
supporting unsolicited output 
transient 
using workstations 


Communications output printer (COP) 
configuring support 
network definition 


Component structure of IMS 


Concurrency 
main storage requirements 
MAXUSERS configurator parameter 
transaction processing 


CONDATA 


CONFID configurator parameter 


Configuration identifier 
CONFID configurator parameter 
NAMEREC file directory 


Configuration process 
control stream examples 
functional flow 
IMSCONF jproc 
job decks 
main storage requirements 
overview 
performing at workstation 
procedure 
recommended approach 
selecting IMSCONF parameters 


Configuration step, configuration process 
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Reference Page 


4.3.5.3 4-70 
Table B-1 — B-2 
Table B-3  B-9 


Fig. 2-1 2-2 


4.2.7 4-22 
41 4-1 


2.3 2-3 
2.3.2.4 2-2 
2.3.2.2 2-1 
C.2.1 C-2 
2.3.2 2-9 
2.3.2.3 2-1 
2.3.2.1 2-1 
2.3.1 2-6 
2.3.2.3 2-1 


4.3.3.1 4-57 
2.3.2.1 2-13 


Appendix D 


C4 C-1 
4.38.12 4-9 
1.1.2 1-2 


See continuity 


data file. 

4.3.1.2 4-46 
4.3.1.2 4-46 
Fig. 4-5 4-18 
4.2.14 4-33 
Fig. 4-1 4-2 
42 4-8 
Fig. 4-2 4-5 
4.2.13 4-31 
41 4-1 
Fig. 4-3 4-6 
4.1.1 4-4 
4.2.6 4-21 
Fig. 4-4 4-1] 
4.1 4-} 


Term 


Configurator 
defining source module 
error processing 
input example 
input parameter summary 
input sections 
listing options, selecting 
main storage requirements 


modules 
performance considerations 


Consolidated data management 


Continuity data area 
specifying largest 
specifying size 


Continuity data file 
allocating at configuration 
AUDCONF (single-thread) 
block size calculation 
CONDATA (multithread) 
cylinder allocation 
initializing at configuration 
1/0 area size 
TOMFILE partition 


Continuous output 
configuring 
main storage requirements 
CONTOUT configuration parameter 
Control-only storage (COS) 
Control streams (configurator) 
coding examples 
job decks 
selecting 
Control tables, main storage requirements 
multithread IMS 
single-thread IMS 


cop 


Copying trace file (magnetic tape) 
COR 


COS code 


Index 3 
Reference Page 
4.2.2 4-17 
44 4-93 
Fig. 4-6 4-44 
Table 4-1 4-37 
43 4-35 
4.2.3 4-17 
Table B-1 B-3 
Table B-3. B-9 
Fig. D-2 D-2 
C.2.9 C-8 
1.4 1-7 
43.2.5 4-53 
4.3.8.4 4-89 
4.2.8 | 4-23 
4.1.2 4-] 
4.3.25 4-53 
4.1.2 4-7 
4.28 4-24 
4.2.8 4-24 
B.3.5 B-12 
4.1.2 4-7 
43.3.1 4-57 
Table B-1 B-2 
Table B-3 _ B-9 
4.3.3.1 4-57 
1.2.1 1-5 
4.2.14 4-33 
Fig. 4-2 4-5 
4.25 4-20 
Table B-4 —- B-10 
Table B-2 ss B-4 


See communications 


output printer. 


743 
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CR job control statement 
CUP configurator parameter 
CUPDATE configurator parameter 


Cursor positioning (DICE function) 


DAM files 
DTF keywords 
file control table size 
main storage requirements 
specifying to configurator 
DAMR files 


Data definition processor 


Data definition record 
record deletion 


Data management 

basic 

consolidated 

DTF keywords 

linking offline recovery utility 

linking tape copy routine 

RIB keywords 
DATE-TIME parameter, offline recovery 
DCT 500 data communications terminal 
DCT 1000 data communications terminal 


DDPBUF configurator parameter 


DDPBUF parameter, IMS start-up 
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Reference Page 


4.2.11 4-30 
43.1.3 4-47 
43.5.3 4-70 
2.4.1 2-27 
Table 4-3 4-75 
Table B-2 B-4 
Table B-4 —- B-10 
Table B-1 B-3 
Table B-3. _B-9 
4.3.5.2 4-70 
See DAM files. 

3.4 3-11 
4.3.8.5 4-90 
3.2.4 3-9 
14 1-7 
14 1-7 
4.3.5.7 4-72 
7.4.2.1 7-10 
7.4.3.1 7-10 
43.5.7 4-72 
7.4.2.2 7-13 
2.3.2 2-9 
2.3.2 2--9 
4.3.2.3 4-52 
5.3.1.4 5-7 


Term 


DDPSESS configurator parameter 

DDPSESS parameter, IMS start-up 
DDRECORD configurator parameter 
Deadlock 

DEBUG parameter, IMS start-up 


Dedicated network 
description 
resident (CAM 
transient ICAM 


Defined file name, specifying 


Defined record area, size calculation 


Defined record management 
configuring (DRCRDMGT section) 
main storage requirements 


residence 
update functions 


DELETE parameter, NAMEREC utility 
DELETP configurator parameter 


Device assignment 
configurator library files 
IMS start-up 
internal files 


Device-independent control expressions 
DFILE configurator parameter 


DICE sequences 
description 
input message editing 
output message length 
specifying to ICAM 


DISCFILE macro 
resident iCAM 
transient ICAM 


Disk buffering file 
allocating 
resident ICAM 
transient ICAM 


Disk queueing files 
allocating file 
resident (CAM 


Index 4 
Reference Page 
4.3.2.4 4-52 
5.3.1.5 5-7 
4.3.85 4-90 
C.4.1 C-11 
5.3.1.6 5-7 
2.2 2-1 
2.3.2 2-8 
2.3.1 2-5 
4.3.8.6 4-90 
Fig. B-2 -6 
Fig. B-4 B-12 
4.3.10 4-99 
Table B-1 = B-3 
Table B-3  B-9 
4.3.10.1 4-100 
4.3.10.2 4-100 
3.2.4 3-9 
4.3.5.4 4-71 
4.2.1 4-11 
5.3.2 5-7 
4.28 4-23 


See DICE sequences. 


4.3.8.6 


2.4.1 
4.3.8.7 
4.3.8.13 
2.3.1 


2.3.2 
2.3.1 


5.3.2 
2.3.2 
2.3.1 


5.3.2 
2.3.2 


4-90 


2-27 
4-91 
4-94 
2-7 


2-11 
2-7 


ret 
—™ WOW wo 


Adee oi 
wow 

















UP-8364 Rev. 7 


Term 


Diskette subsystem 


Distributed data processing 
DDPBUF configurator parameter 
DDPSESS configurator parameter 
LOCAP configurator parameter 
LOCAP parameter, IMS start-up 
LOCAP section, configurator input 
network definition 
storage requirements 


DLLOAD configurator parameter 
DLMSG transaction code 

entered by terminal operator 

IMS. start-up 
DMS configurator parameter 
Downline loading 

configuring 

main storage requirements 
DRCRDMGT section, configurator input 
DRM 
DTF 

keyword parameters 


mode 


object module name 
source module name 


Dynamic session 
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Reference Page 


2.3.2 2-8 
4.3.2.3 4-52 
43.2.4 4-52 
4.3.7.3 4-86 
5.3.1.3 5-6 
43.11 4-100 
2.3.2.4 2-21 
B.3.6 B-13 
4.3.3.2 4-58 
7.2.2 7-3 
5.3.1.1 5-4 
4.3.3.3 4-58 
4.3.3.3 4-58 
Table B-1 = B-2 
Table B-3.  B-9 
4.3.12 4-102 
See defined record 
management. 
4.3.5.9 4-73 
1.4 1-7 
4.2.4 4-20 
4.3.1.2 4-46 
4.3.1.2 4-46 
2.3.2.2 2-16 


Term 


EDIT configurator parameter 
Edit table utility 


Editing input messages 
EDIT configurator parameter 
edit table utility 
FCCEDIT configurator parameter 
main storage requirements 


ERET configurator parameter 


Error, return of contro! to action 
program 


Error codes and diagnostics 
batch processor 
configurator 
password 


Error processing, configurator 


Extending trace file (disk) 


FASTLOAD configurator parameter 
FCCEDIT configurator parameter 


Field control characters (FCCs) 
description 
editing requirements 


File control table sizes 
multithread IMS 
single-thread IMS 


File identifier, internal files 
File name specification 


DFILE configurator parameter 
FILES configurator parameter 





Index 5 
Reference Page 
43.8.7 4-91 
3.3 3-11 
4.3.8.7 4-91 
3.3 3-11 
4.3.8.8 4-92 
Table B-1 = B-3 
Table B-3. —-B-9 
4.3.9.2 4-98 
4.3.9.2 4-98 
Table F-3 F-9 
Table F-2 F-2 
Table F-1 F-1 
44 4-93 
5.3.1.2 5-5 
4.3.3.4 4-58 
4.3.8.8 4-92 
2.4.2 2-27 
43.8.8 4-92 
Table B-4 = B-10 
Table B-2 B-4 
4.2.8 4-23 
4.3.8.6 4-90 
4.3.8.9 4-92 
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Term 


File rollback/recovery 

offline recovery 

online recovery 
FILE section, configurator input 
File tracing, suppressing 
File updating 

configuring 

main storage requirements 
Filename configurator parameter 
FILES configurator parameter 
FILES parameter, offline recovery 
FILETYPE configurator parameter 
Forms contro! (DICE function) 
Forward recovery 


Function keys 


FUPDATE configurator parameter 


GENERAL section, configurator input 


Global network 
defining to configurator 
description 
loading GUST 


main storage requirements 
network definition 
supporting multiple programs 
using workstations 


Global user service task 


GUST 


G 


Reference 


74 
73 


435 
43.5.6 
43.3.6 
Table B-1 
Table B-3 
43.5.1 
4.3.8.9 
74.2.2 
4.3.5.2 
2.4.1 
7411 
43.7.1 


4.3.3.6 


4.3.1.3 


5.2.2 
Table B-1 
Table B-3 
2.3.2.2 
2.3.2.3 
2.3.2.3 


5.2.2 
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> 
on 
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5-2 


See global user 


service task. 


IBM 3270 terminal 
general 
specifying DICE=OFF 


creating 

global network 

loading 

network definition macros 
resident network 
transient network 


IMS/DMS._ interface 
IMS READY message 
displayed at start-up 
suppressing 
IMS specification (SYSGEN) 
IMSCONF jproc 
call line format 
job control stream 
selecting parameters 
subordinate procedures 
IMSFIL[n] parameter, IMSCONF jproc 
IMSGEN specification (SYSGEN) 
IMSREADY configurator parameter 
IMS#NTZ procedure (IMSCONF) 


IMS#SCR procedure (IMSCONF) 


index 6 
Reference Page 
2.3.2 2-8 
2.3.2 2-9 
2.2 2-1 
2.3.2.2 2-16 
5.2.1 5-1 
Table 2-2 2-4 
2.3.2 2-9 
2.3.1 2-6 
4.3.3.4 4-58 
5.3 5-3 
4.3.6.2 4-83 
1.2.1 1-5 
4.2 4-8 
42.14 4-33 
Fig. 4-4 4-11 
4.1 4-1 
4.2.8 4-24 
1.2.1 1-6 
4.3.6.2 4-83 
4.1 4-1 
4) 4-1 
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Term 


IN parameter, IMS start-up 
INBUFSIZ configurator parameter 


INIT parameter 
IMSCONF jproc 
NAMEREC utility 


Initial program load (IPL), SYSRES 
volume defined 


Initialization step, configuration 
process 


Input message area, length specification 


Input messages 
DICE sequences 
editing requirements 
lowercase-to-uppercase translation 
removing DICE sequences and FCCs 
urgent priority character 
urgent priority terminal 
See also editing input messages. 


INPUT parameter, IMSCONF jproc 
INSIZE configurator parameter 
Installing IMS 


Integrated communications access method 


Internal files 


Internal message control 
multithread modules 
single-thread modules 


INTLIST configurator parameter 


1/0 areas 
audit file 
continuity data file 
trace file 


IRAM files, specifying to configurator 
ISAM files 

DTF keywords 

file control table size 


main storage requirements 


specifying to configurator 


Reference 


5.3.1.8 


4.3.25 


4.2.9 
3.2.1 


4.2.1 


41 


4.3.8.10 


2.4.1 
43.8.7 
4.38.15 
4.3.8.7 
4.3.2.6 
4.3.6.5 


4.2.2 


4.3.8.10 


1.2 


See ICAM. 


4.1.2 


Fig. D-13 
Fig. D-7 


4.3.3.5 


B.2.5 
B.3.5 
B.2.6 


4.3.5.2 


Table 4-2 
Table B-2 
Table B-4 
Table B-1 
Table B-3 
4.3.5.1 
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4-1 
4-93 
2-27 
4-91 
4-90 
4-91 
4-54 
4-84 
4-17 


4-93 


4-7 


Index 7 





Term 


JOB control statement 
configuration main storage requirement 
IMS job region size 
recovery, main storage requirement 
tasks, specifying number 


Job region size 


KATAKANA configurator parameter 


L 


LANGUAGE section, configurator input 
language-element, configurator parameter 
lexicon-name, configurator parameter 
LIBL parameter, IMSCONF jproc 

LIBO parameter, IMSCONF jproc 
Library files, assigning to configurator 
LIBS parameter, IMSCONF jproc 

Line control (DICE function) 

Line disconnect feature, support 

Line feed (DICE function) 

Line length, message 

LINE macro 


resident ICAM 
transient ICAM 


Reference Page 


4.2.13 4-31 
B.2 B-1 

6.4.2.3 6-17 
0.4.2 C-11 


See main storage 
requirements. 


4.3.1.4 4-47 
4.3.10 4-99 
4.3.10.2 4-100 


4.3.10.1 4-100 


4.2.1 4-12 
4.2.1 4-11 
4.2.1 4-10 
4.2.1 4-10 
2.4.1 2-27 
4.3.3.1 4-57 
2.4.1 2-27 
4.3.2.2 4-52 
2.3.2 2-9 

2.3.1 2-6 
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Term Reference Page Term Reference Page 
Lines per message, specifying 4.3.2.6 4-54 M 
LIST command, interrupting 4.3.3.6 4-59 Main storage requirements 
" basic IMS 4.3.3.1 4-57 
LIST parameter, NAMEREC utility 3.2.2 3-4 configuration job 4.2.13 4-31 
. configuration options Table B-1  B-2 
LNS/MSG configurator parameter 4.3.2.4 4-52 Table B-3. B-9 
control tables Table B-2 B-4 
Load module name, IMS 4.2.10 4-29 Table B-4 B-10 
; distributed data processing B.3.6 B-13 
LOADM parameter, IMSCONF jproc 4.2.10 4-29 global user service task 5.2.2 5-2 
’ multithread IMS B.3 B-8 
LOCAP configurator parameter 4.3.7.3 4-86 offline recovery utility 7.4.2.3 7-17 
single-thread IMS B.2 B-1 
LOCAP macro 2.3.2.2 2-16 tape copy routine 74.3.2 7-22 
LOCAP parameter, IMS start-up 9.3.1.3 5-6 MASTER configurator parameter 43.6.3 4-83 
LOCAP section, configurator input 43.11 4-100 Master terminal, designating 43.6.3 4-83 
locap-name, configurator parameter 43.111 4-101 MAXCONT configurator parameter 43.27 4-60 
LOCK configurator parameter 4.3.5.5 ae MAXSIZE configurator parameter 4.38.11 4-93 
Lock for transaction 4.3.5.4 4-71 MAXUSERS configurator parameter 438.12 4-94 
Lock for update 4.3.5.4 4-71 Message length 
line length 4.3.2.2 4-52 
Locking, record 4.3.3.10 4-61 lines per message 43.2.4 4-52 
4.3.5.4 4- 
MIRAM files 
Lowercase-to-uppercase translation 4.3.8.15 4-96 DIF keywords Table 4-6 4-78 
: file control table size Table B-2 B-4 
LST parameter, IMSCONF jproc 4.2.3 4-18 Table B-4 —- B-10 
main storage requirements Table B-1  B-2 
Table B-3 —_B-9 
recovery restriction 7.3.2 7-6 
7.4.1.3 7-9 
RIB keywords Table 4-7 4-80 
specifying to configurator 4.3.5.1 4-69 
ML$$GI program 5.2.2 5-2 
Modules, IMS Appendix D 
MSGLR configurator parameter 4.3.3.7 4-60 
MSGPOS configurator parameter 4.3.3.8 4-60 
Multithread IMS 
compared with single-thread 1.1.2 1-2 
concurrent processing C.4 C-10 
configuring 4.25 4-20 
main storage calculations B.3 B-8 
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Reference Page Term ee Reference Page 
N Offline recovery utility 
executing 74.2.3 
NAME configurator parameter 4.3.1.5 4-48 linking 7421 
parameters 74.2.2 7-13 
Named record file See NAMEREC file. ; 
Online linkage step, configuration process 41 4-1 
NAMEREC file ; : 
allocating at configuration 4.28 4-23 Online processing modules 
assigning at IMS start-up 5.3.2 5-9 multithread Fig. D-10 D8 
block size, determining 0.2.2 C-3 single-thread Fig D-4 0-3 
block size, specifying 3.2.1 3-2 
4.2.9 4-26 Online recovery 
initializing at configuration 4.2.9 4-27 audit file 721 1-2 
initializing with NAMEREC utility 3.2.1 3-2 terminal output message file 1.22 1-3 
listing directory 4.23 4-17 transaction rollback 7.3.1 7-6 
listing record names 3.2.2 3-4 warm restart 13.2 1-6 
optimizing disk space C.2.2 C-3 
reformatting C22 C-3 OPCOM configurator parameter 4.3.3.9 4-61 
scratching/reinitialization Fig. 3-2 3-4 
4.2.9 4-26 OPTION OFT Job control statement 5.3.2 5-9 
NAMEREC file utility OPTIONS section, configurator input 4.3.3 4-55 
error processing 3.2.5 3-10 
listing record names 3.2.2 3-4 0S/3 release volume (0S3/REL) 
NAMEREC file initialization 3.2.1 3-3 CCA object module stored 2.2 2-3 
© password definition 3.23 3-6 CCA parameter default 4.2.7 4-22 
initial program load (IPL) 4.2.1 4-10 
Network definition, ICAM 23 2-3 LIBO parameter default 4.2.1 4-1] 
ZCNF parameter default 4.25 4-20 
NETWORK section, configurator input 
format and example 431 4-45 OUTPUT configurator parameter 4.3.5.6 4-72 
sample listing Fig. 4-7 4-50 
Fig. 4-8 4-50 Output message area, length specification 4.3.8.13 4-94 
Output messages 
DICE sequences 2.4.1 2-27 
field control characters (FCCs) 2.4.2 2-27 
ICAM buffers 2.3.1 2-7 
2.3.2 2-11 
recorded in TOMFILE 7.2.2 7-3 
text length 4.3.8.13 4-94 
oO using LBL operand 2.3.2 2-19 
Offline recovery (user data files) QUTSIZE configurator parameter 4.3.8.13 4-94 
backward recovery 7.4.1.2 7-8 
configuring 4.33.11 4-62 
forward recovery TALL 7-7 
main storage requirements Table B-1 B-2 
Table B-3 B-9 
offline recovery utility 74.2 7-10 
quick recovery 74.1.3 7-9 
reconstructing TOMFILE 4.3.3.18 4-64 
@ sample control stream 7.4.2.3 7-17 
tape copy routine 743 7-21 
trace file 7.2.3 7-3 








Term 


PRCS macro 


Priority, IMS job 


Process file 


Quick recovery 
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Reference Page Term Reference Page 
P 
PARAM job control statements 
IMS start-up 5.3.1 5-3 
linking offline recovery 7.4.2.1 7-10 
linking tape copy routine 7.4.3.1 7-21 
Partial file recovery 7.4.2.2 7-13 
PASSWORD configurator parameter 4.3.1.6 4-48 
PASSWORD parameter 
NAMEREC utility 3.2.3.1 3-7 
resident ICAM 2.3.2 2-10 
transient ICAM 2.3.1 2-7 
Password processing 
password definition 3.2.3.1 3-7 
password deletion 3.2.4 3-9 R 
Password-protected files, identifying 4.2.12 4-31 RCHAR, configurator parameter 43.112 4-101 
Performance considerations Appendix C RECLOCK configurator parameter 433.10 4-61 
PFILES parameter, offline recovery 74.2.2 7-14 Record lock 
; configuring 4.3.3.10 4-61 
PKEY configurator parameter 4.3.5.7 4-72 main storage requirements Fig. B-4 B-12 
types 4.3.5.5 4-7 
2.3.2.1 2-13 
: ; Recovery 
Pre-online processing 3.1 3-1 offline 14 7-7 
' online 7.3 7-6 
PRINT parameter, offline recovery 7.4.2.2 7-14 options summary Table 7-1 7-4 
9.3.2 5-9 RECOVERY configurator parameter 433.11 4-62 
Priority processing (input messages) RECOVERY-TYPE parameter, offline recovery 7.4.2.2 7-13 
urgent character 43.2.9 4-55 
urgent terminal 4.3.6.5 4-85 Reentrant action programs 
ALLRNT configurator parameter 4.3.8.2 4-88 
23.21 2-13 TYPE configurator parameter 4.3.9.5 4-99 
Program-name configurator parameters Reinitializing NAMEREC file 
ACTION section 4.3.8.1 4-88 IMSCONF jproc 429 4-26 
PROGRAM section, configurator input 4.3.9 4-97 RESEND configurator parameter 433.12 4-59 
Reserved words A2 A-3 
Q 
RESFMT configurator parameter 4.3.3.13 4-63 
7.4.1.3 7-9 
RESIDE configurator parameters i 
DRCRDMGT section 4.3.12.1 4-102 
PROGRAM section 4.3.9.3 4-98 
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& Term Reference Page Term Reference Page 
Residence Security dump 7411 7-7 
action programs 4.3.9.3 4-98 
defined record management 4.3.10.1 4-100 SEND function, support 4.3.3.21 4-66 
ICAM Table 2-1 2-3 
UNIQUE Table B-1  —_ B-2 SESSION macro 2.3.2.2 2-16 
Resident ICAM network 2.3.2 2-9 SFS configurator parameter 4.3.3.14 4-63 
RESTART parameter, IMS start-up 5.3.1.1 5-4 Shared-code action programs 4.3.9.5 4-99 
Reusable action programs 4.3.9.5 4-99 SHOW command (UNIQUE) 2.3.1 2-7 
RIB keyword parameters 4.3.5.9 4-73 SHRDSIZE configurator parameter 4.3.8.14 4-96 
Rollback point Single-thread IMS 
audit file 4.3.2.1 4-51 compared with multithread 1.1.2 1-2 
backward recovery 7.4.1.2 7-8 configuring 4.25 4-20 
forward recovery 7.4.1.1 7-7 main storage requirements B.2 B-1 
online recovery 7.3 7-6 
quick recovery 7.4.1.3 7-9 SNAPED configurator parameter 43315 4-63 
trace file 7.2.3 7-3 oe 
Snapshot dump, edited directory 
configuring 4.3.3.15 4-63 
main storage requirements Table B-3—-B-9 
& START parameter, IMS start-up 5.3.1.1 5-4 
STARTUP parameter, IMS start-up 5.3.1.1 5-4 
STATFIL, see statistical data file 
Static session 2.3.2.2 2-16 
Statistical data file 
allocating at configuration 4.2.8 4-23 
initializing at configuration 4.2.9 4-26 
Ss Statistical reporting 
; configuration requirements 8.3 8-5 
SAM files file statistics 8.2.1 8-2 
disk DTF keywords Table 4-4 = 4-76 functions 81 8-1 
file control table size Table B-2 B-4 offline printing 85 8-6 
Table B-4 —-B-10 online recording 8.4 8-5 
main storage requirements Table B-l1 = B-3 program statistics 8.22 8-2 
-_ Table B-3 B-9 startup requirements 8.3 8-5 
specifying to configurator 4.3.5.2 4-70 statistics file layout 86 8-6 
tape DIF keywords Table 4-5 4-77 terminal statistics 8.2.4 8-4 
tape RIB keywords Table 4-8 4-82 transaction statistics 8.2.3 8-3 
STATS configurator parameter 4.3.3.16 4-64 
Screen erasure (DICE function) 2.4.1 2-27 
STATUS configurator parameter 4.3.4.2 4-68 
Screen format services 
configuring 4.33.14 4-63 Storage protection feature 1.1.2 1-2 
& main storage requirements Table B-1 = B-2 
output message area size 4.3.8.13 4-94 SUBPROG configurator parameters 
specifying at start-up 9.3.2 9-9 OPTIONS section 4.33.17 4-64 


PROGRAM section 4.3.9.4 4-98 
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Term Reference Page Term Reference Page 
Subprograms Terminal printer 2.3.2 2-8 
configuring support 4.3.3.17 4-64 
identifying 4.3.9.4 4-98 TERMINAL section, configurator input 43.6 4-82 
main storage requirements Table B-1 = B-2 
Table B-3. _ B-9 Terminals 
attributes 4.3.6 4-82 
SWTCH transaction, supporting 43.3.21 4-66 defining to configurator 4.3.6 4-82 
maximum online 4.3.1.6 4-48 
System console resident network 2.3.2 2-8 
as master terminal 4.3.6.3 4-83 transient network 2.3.1 2-5 
System generation (SYSGEN) Terminating IMS session 5.4 5-12 
considerations for IMS 1.2.1 1-5 
C.2.8 C-6 TERMS configurator parameter 4.3.1.7 4-48 
ICAM generation 2.2 2-1 
Thread contro! block, main 
System installation See system storage calculation Fig. B-4 B-12 
generation. 
Time-fill sequences (DICE) 2.3.1 2-6 
System resident volume (SYSRES) 
creating at SYSGEN 1.2.1 1-5 TIMEOUTS section, configurator input 4.3.4 4-63 
defined as IPL volume 4.2.1 4-10 
IMSFIL parameter default 4.2.7 4-22 Timing factors, IMS performance Table C-1  C-10 
LIBL and LIBS parameter default 4.2.1 4-10 
Timing out action program 43.4.1 4-66 
TOMFILE configurator parameter 4,3.3.18 4-64 
TOMFILE partition 
description 7.2.2 7-3 
generating 4.3.3.18 4-64 
main storage requirements Table B-1  B-2 
Table B-3_—B-9 
tracing 4.3.3.19 4-65 
T TOMTRCE configurator parameter 4.3.3.19 4-65 
TRACE configurator parameter 43.5.8 4-73 
Tape cassette system (TCS) 2.3.2 2-8 
; Trace file 
Tape copy routine assigning at IMS start-up 5.3.2 5-7 
executing 1.4.3.2 1-22 closing on disk 5.3.1.2 5-5 
linking 7.4.3.1 7-21 closing on tape 7.43 7-21 
hae configuring 4.33.11 4-62 
Tasks, assigning at IMS start-up C.4.2 C-11 description 7.23 7-3 
; extending on disk 9.3.1.2 5-5 
TELETYPE terminals (TTY) 2.3.2 2-8 file size calculation 5.3.2 5-7 
1/0 area size B.2.6 B-7 
TERM macro listing records 74 7-7 
resident ICAM 2.3.2 2-9 offline recovery 74 7-7 
transient ICAM 23.1 2-6 prefix area content Table 7-2 7-5 
a. * ; prefix area format Fig. 7-1 7-4 
Terminai-id configurator parameter 4.3.6.1 4-83 
; - Tracing output messages 4.3.3.19 4-65 
Terminal output message partition 4.3.3.18 4-64 


See also TOMFILE partition. 
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@ Term Reference Page Term ~ Reference Page 
TRANLEN configurator parameter 4.3.2.8 4-55 UNIQUE configurator parameter 4.3.3.20 4-65 
Trans-code configurator parameter 43.7.1 4-85 UNIQUE language elements Table E-1 E-1 
TRANSACT section, configurator input 4.3.7 4-85 UNISCOPE 100 and 200 Display Terminals 

resident ICAM 2.3.2 2-8 
Transaction code 4.3.7.1 4-85 transient ICAM 2.3.1 2-5 
Transaction contro! interface (TCI) 2.1 2-1 UNSOL configurator parameters 
OPTIONS section 4.3.3.21 4-66 
Transaction processing 1.1.1 1-2 TRANSACT section 4.3.6.4 4-84 
Transaction termination record Unsolicited output 
audit file 7.2.1 7-2 configuring 4.3.3.18 4-62 
trace file 7.2.3 7-3 main storage requirements Table B-l — B-2 
Table B-3.  B-9 
Transient (ICAM) network 2.3.1 2-6 notification at terminal 4.3.6.4 4-84 
resident ICAM required 2.3.2 2-9 
TRANSLAT configurator parameter 4.3.8.15 4-96 
UPDATE configurator parameter 4.3.12.2 4-102 
TRCFILE See trace file. 
Update functions, defined record 
TRCFILE parameter management 4.3.10.2 4-100 
IMS. start-up 5.3.1.2 5-5 
offline recovery utility 74.2.2 7-15 Updating files 

& FUPDATE configurator parameter 4.3.3.5 4-59 

TYPE configurator parameter 43.9.5 4-99 UPDATE configurator parameter 4.3.10.2 4-100 


URGENT configurator parameters 


TERMINAL section 4.3.6.5 4-84 
TRANSACT section 4.3.7.5 4-87 
User data files 
accessed by an action 4.3.8.9 4-92 
assignment to IMS start-up 5.3.2 5-9 
described to configurator 43.5 4-68 
DIF keywords 43.5.7 4-72 
identifying 4.3.5.1 4-69 
maximum number 4.3.5 4-68 
offline recovery 74 7-7 
online recovery 73 7-6 
referenced by defined file 43.5.1 4-69 
RIB keywords 4.3.5.7 4-72 
See also DAM, IRAM, ISAM, MIRAM, 
and SAM files. 
U 
UTS 10 Terminal 2.3.2 2-8 
UCHAR configurator parameter 4.3.2.9 4-55 
UTS 20 Terminal 2.3.2 2-8 
UNDEF configurator parameter 4.3.7.4 4-87 
UTS 400 Terminal 
Uniform inquiry update element (UNIQUE) downline loading 4.3.3.2 4-58 
main storage requirements Table B-1 B-2 field control characters (FCCs) 2.4.2 2-27 
& Table B-3. —_B-9 resident ICAM supports 2.3.2 2-9 
residence 4.3.3.20 4-65 
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Term 


Volatile data area 


WARM start-up 


Work area 
main storage requirement 


size specification 
WORKSIZE configurator parameter 


Workstation 
configuring IMS 
loading ICAM 
supported by ICAM 
network definition 
sample network 
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Reference Page Term Reference Page 
Zz 
4.3.8.14 4-96 ZCNF parameter, IMSCONF jproc 424 4-20 
ZCHICP program See tape copy 
routine. 
5.3.1.1 5-4 ZCHTRC utility See offline 
recovery utility. 
Fig. B-2 B-6 ZP#NRU utility See NAMEREC 
Fig. B-4 B-12 file utility. 
4.3.8.16 4-97 
ZZCLS master terminal command 7.4.2.2 7-15 
4.3.8.16 4-97 
ZZHLT master terminal command 
terminating IMS session 5.4 5-15 
4.1.1 4-4 
5.2.1 5-1 ZZOPN master terminal command 74.2.2 7-15 
2.3.2 2-8 
Fig. 2-11 2-19 ZZRSD terminal command, disallowing 4,3.3.12 4-62 
Fig. 2-12 2-20 


ZZSHD master terminal command 
terminating IMS session 5.4 5-15 


ZZTST master terminal command 4.3.3.21 4-66 
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